保利威文档中心

幫助中心

使用者體系-訪客登入

更新時間:2026-01-19 09:16:42

使用者體系-訪客登入

此文件僅適用透過 觀看頁 SDK 及配套的 直播觀看頁開源專案 進行二次開發的客戶

一、方案說明

  • 在使用者體系下,您需要在「雲直播後台」開啟「訪客模式」開關,即可實現訪客功能。
  • 「訪客模式」開啟後,觀看頁預設會以訪客身分登入,後續建議透過 使用者體系-獨立授權 來實現 訪客 註冊/登入成 使用者

特別注意:

  • 在使用者體系下,直播觀看頁已原生支援訪客功能
  • 使用者以訪客身分存取觀看頁時,目前僅能正常觀看直播畫面及聊天室內容,無法在聊天中發言,也無法參與互動。
  • 訪客註冊成為新使用者後,保利威會繼續使用同一個使用者 Id。若登入成已註冊使用者,則會是兩個不同的使用者 Id

二、概念說明

  • 訪客授權:當前觀眾能夠以 訪客身分 存取觀看頁
  • 訪客登入:當前觀眾從 訪客身分 需要轉換為 正式使用者,此份文件會借助 使用者體系-獨立授權 的方式來實現

三、具體步驟

注意:此處是以訪客模式先進入觀看頁,後續再進行 使用者體系-獨立授權 登入的場景。具體的程式碼截圖請參考 直播觀看頁開源專案2.9.0 版本

1. 開啟「訪客模式」開關


雲直播後台-使用者設定

2. 訪客授權存取觀看頁

此步驟已內建於直播觀看頁專案中,此處僅便於您確認訪客授權邏輯,無需額外處理

src/store/use-identity-store.ts 會記錄目前的使用者資料及訪客身分

use-identity-store.ts

在觀看頁載入時,會處理使用者登入的攔截,具體在 src/app/_hooks/use-user-identity-intercept.ts 檔案中

目前保利威會因某些技術實作,限制部分場景不支援訪客存取,需先登入成正式使用者,如有疑問可諮詢保利威售後團隊

use-user-identity-intercept.t

預設使用者登入的邏輯是在獨立的頁面,具體在 src/app/layout/direct-business-page_components/page-watch-identify/page-watch-identify.vue 檔案中

page-watch-identify.vue

注意: 截圖為訪客授權觸發的回呼,回呼後會重新整理頁面。至此,訪客授權完成,可正常存取觀看頁

3. 實現訪客登入成使用者

觀眾以訪客身分存取觀看頁時,目前僅能正常觀看直播畫面及聊天室內容,無法在聊天中發言,也無法參與互動。

當訪客想參與互動時,保利威目前的互動流程是先開啟確認框,確認後再開啟保利威的使用者登入彈窗

watch-page-guest-confirm
watch-page-user-login-popup

這部分互動邏輯,對應在直播觀看頁專案中,其實是觸發了一個 appEvents.global.OpenIdentityLoginDialog 事件的回呼,可以在 src/components/common-business/watch-identity/identity-login-dialog-render/use-identity-login-dialog-render.ts 檔案中監聽到該事件的回呼

OpenIdentityLoginDialog

從程式碼截圖中可以看到,在事件回呼後,會開啟一個確認框,等確認後再開啟登入彈窗

注意:此時您可以在 @PLV-WARN 處開始對接 使用者體系-獨立授權,也可先根據自身業務需求進行額外處理。這裡建議您在使用者獨立授權完成後,重新載入一次當前頁面,以確保登入後的使用者能正常使用觀看頁的功能

另外,具體的元件程式碼在 src/components/common-business/watch-identity/identity-login-dialog-render/mobile-identity-login-dialog-render.vue 檔案中

loginDialogRender

如果您不需要進行其他 UI 客製,只需快速對接 使用者體系-獨立授權,則可直接在 src/components/common-business/watch-identity/identity-login-dialog-render/watch-identify-login-content.vue 中傳遞獨立授權相關的參數即可

directAuthParams

注意: 獨立授權參數預設會從觀看頁的 url 上取得,請根據您的實際需求進行調整

联系客服,在线咨询