游客模式与自研用户体系对接指南
更新时间:2026-09-28 17:51:05
1. 适用场景
本文适用于接入方已有自研用户体系,希望观看页观众先以游客身份进入保利威观看页,并在需要登录时通过接入方登录流程转换为正式用户身份的场景。
典型诉求包括:
- 未登录观众可以先进入观看页浏览内容。
- 观众触发互动、发言等需要身份的操作时,再进入接入方登录流程。
- 观众在接入方登录页完成登录后,将自研用户身份同步到保利威观看页。
- 保利威观看页后续以正式用户身份识别该观众。
游客模式可以用于内嵌 SaaS 观看页,也可以用于集成 Web 观看页 SDK。两类接入方式的登录触发方式不同。
2. 解决方案一:内嵌 SaaS 观看页
2.1 实现方式
适用于直接使用保利威 SaaS 观看页,并通过网页、APP 或小程序内嵌方式打开观看页的场景。
接入方可复用 SaaS 观看页的游客访问和登录引导能力,同时保留自研登录体系。观众需要登录时,由观看页引导至接入方登录页;完成登录和用户体系独立授权后,返回观看页以正式用户身份使用。
后台配置参考:

2.2 对接流程

注意事项:
- 外部登录地址及登录后的回跳方式需要适配实际终端,例如浏览器、APP 或小程序。
- 独立授权所需参数和签名由接入方服务端按开发文档要求生成。
技术对接:SaaS 场景的用户体系独立授权,请参阅《用户体系-独立授权》开发文档。接口参数、签名规则及调用方式以该文档为准。
3. 解决方案二:集成 Web 观看页 SDK
3.1 实现方式
适用于通过观看页 SDK 及配套的直播观看页开源项目进行二次开发,需要定制观看页和登录交互的场景。
接入方可在开源观看页的登录处理环节接入自研登录流程,结合已有页面路由、弹窗和账号体系完成用户体系独立授权,并按开发文档处理登录后的页面状态。
后台配置参考:

3.2 对接流程

注意事项:
- 游客访问存在场景限制,具体支持范围请查阅开发文档;如有疑问,可联系保利威售后团队。
- 技术实现需与实际使用的项目版本对应。
技术对接:游客授权、登录对接及登录后的页面处理,请参阅《用户体系-游客登录》开发文档的「三、具体步骤」。相关代码位置、事件处理及授权参数配置统一以该文档及其引用的「用户体系-独立授权」文档为准。
4. 方案对比
| 对比项 | 内嵌 SaaS 观看页 | 集成 Web 观看页 SDK |
|---|---|---|
| 观看页形态 | 使用保利威 SaaS 观看页 | 基于观看页 SDK 及配套开源项目二次开发 |
| 登录触发方式 | SaaS 观看页展示登录引导 | 在开源观看页的登录处理环节对接 |
| 登录流程提供方 | 接入方 | 接入方 |
| 登录入口展示 | SaaS 观看页引导 | 接入方可按业务需要定制 |
| 游客外部登录配置 | 开启并配置外部登录地址 | 按开发文档及具体实现完成登录对接 |
| 自研用户身份对接 | 用户体系独立授权 | 用户体系独立授权 |
| 正式身份进入方式 | 完成授权后返回 SaaS 观看页 | 完成授权后按开发文档处理页面重新加载 |
| 接入方前端开发量 | 较低 | 较高 |
| 适合情况 | 希望复用 SaaS 观看页能力 | 需要定制观看页和登录交互 |


