保利威文档中心

帮助中心

用户体系-游客登录

更新时间: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 上获取,请根据您的实际需求进行调整

联系客服,在线咨询