訪客模式與自研用戶體系對接指南

1. 適用場景

本文適用於接入方已有自研用戶體系，希望觀看頁觀眾先以訪客身份進入保利威觀看頁，並在需要登入時透過接入方登入流程轉換為正式用戶身份的場景。

典型需求包括：

• 未登入觀眾可以先進入觀看頁瀏覽內容。
• 觀眾觸發互動、發言等需要身份的操作時，再進入接入方登入流程。
• 觀眾在接入方登入頁完成登入後，將自研用戶身份同步到保利威觀看頁。
• 保利威觀看頁後續以正式用戶身份識別該觀眾。

訪客模式可用於內嵌 SaaS 觀看頁，也可用於整合 Web 觀看頁 SDK。兩類接入方式的登入觸發方式不同。

2. 解決方案一：內嵌 SaaS 觀看頁

2.1 實現方式

適用於直接使用保利威 SaaS 觀看頁，並透過網頁、APP 或小程式內嵌方式開啟觀看頁的場景。

接入方可複用 SaaS 觀看頁的訪客訪問和登入引導能力，同時保留自研登入體系。觀眾需要登入時，由觀看頁引導至接入方登入頁；完成登入和用戶體系獨立授權後，返回觀看頁以正式用戶身份使用。

後台配置參考：

2.2 對接流程

注意事項：

• 外部登入地址及登入後的回跳方式需要適配實際終端，例如瀏覽器、APP 或小程式。
• 獨立授權所需參數和簽名由接入方服務端按開發文檔要求生成。

技術對接：SaaS 場景的用戶體系獨立授權，請參閱《用戶體系-獨立授權》開發文檔。介面參數、簽名規則及呼叫方式以該文檔為準。

3. 解決方案二：整合 Web 觀看頁 SDK

3.1 實現方式

適用於透過觀看頁 SDK 及配套的直播觀看頁開源專案進行二次開發，需要客製觀看頁和登入互動的場景。

接入方可在開源觀看頁的登入處理環節接入自研登入流程，結合既有頁面路由、彈窗和帳號體系完成用戶體系獨立授權，並按開發文檔處理登入後的頁面狀態。

後台配置參考：

3.2 對接流程

注意事項：

• 訪客訪問存在場景限制，具體支援範圍請查閱開發文檔；如有疑問，可聯繫保利威售後團隊。
• 技術實現需與實際使用的專案版本對應。

技術對接：訪客授權、登入對接及登入後的頁面處理，請參閱《用戶體系-訪客登入》開發文檔的「三、具體步驟」。相關程式碼位置、事件處理及授權參數配置統一以該文檔及其引用的「用戶體系-獨立授權」文檔為準。

4. 方案比較