开播小助手常见问题

链接规则说明

/**
 * 开播链接由 getLiveJumpUrl 接口生成，下方为参数说明
 * app_server: 您所部署的服务端 AppServer 的域名，若是默认端口，可以不带，但请勿包含路径
 * token: 用于校验身份的字符串，由接口生成
 * user_id: 登录的用户ID
 * user_name: 登录的用户昵称
 * live_id: 进入的直播间ID
 * version: 用于通知开播助手使用哪个版本的互动消息SDK，目前值支持: v1 / v2
 *  v1: 将使用旧版互动消息SDK，https://help.aliyun.com/zh/live/user-guide/interactive-messaging
 *  v2: 将使用新版互动消息SDK，https://help.aliyun.com/zh/live/user-guide/live-interactive-messages-new
 */
const pusherUrl = `
auipusher://page/live-room?
  app_server=http://your-domain.com:80
  &token=your-token
  &user_id=AUILivePusher
  &user_name=AUILivePusher
  &live_id=9ebd0a6a-8ff9-4627-91c4-2025460620de
  &version=v1
`;

AppServer端口

为了确保服务端校验开播链接的合法性，AppServer域名不带端口时，将会使用默认的端口（http默认端口为80，https默认端口为443），若需要使用别的端口，可以按照下图所示修改服务端获取开播链接的接口逻辑。

AppServer路径

为确保开播小助手能够正确解析开播链接中的app_server参数值，并用于各个接口的调用，例如获取直播间详情接口/v1/live/get，建议不要在传入的AppServer中包含路径。

如果传入的AppServer带有路径，例如http://your-domain.com/path，那么调用登录接口将会变成http://your-domain.com/path/v1/live/get。除非您的服务端接口路由都统一加上了相同的前缀，否则这样的接口调用可能会导致错误。

因此，为了避免出现错误，建议在传入的AppServer参数中不要包含路径。

Version版本

开播链接中的version参数对于开播小助手功能至关重要，传错值将会导致无法正常开播。它的作用是通知小助手使用哪个版本的互动消息SDK，目前仅支持传入v1或v2。

• 如果未包含该字段，默认值为v1。当值为v1时，使用的是直播互动消息；

• 当值为v2时，使用的是直播互动消息（新））。

为了确保正确使用互动消息服务，建议修改服务端接口/getLiveJumpUrl的逻辑，根据实际使用的互动消息服务，在返回的开播链接中加上该参数。或者在输入开播链接时手动加上该参数，以确保使用正确的互动消息SDK版本。

登录失败

对于登录失败的原因，可以根据toast提示来进行判断并采取相应的措施。

• 如果开播链接已过期失效或直播间已结束等情况属于正常情况，可以提示用户尝试重新获取开播链接后再次尝试。

• 如果是其他情况导致的登录失败，需要确保服务端的/verifyAuthToken和/get接口能够正常调用。

• 此外，可以使用快捷键（Windows：CTRL + F1，Mac：Command + F1）来开启控制台，以查看各个接口的调用情况，进一步排查登录失败的具体原因。

Windows双击无反应

首先需要确定登录失败的具体原因。

1. 打开cmd终端（建议以管理员身份打开），进入开播小助手的安装目录。

2. 在该目录下输入命令"start 开播小助手.exe"并按下回车键执行，观察是否有报错信息输出。

GPU异常

如果遇到"GPU process isn't usable. Goodbye."的错误，请检查应用是否安装在C盘下。若不是，建议卸载该应用，然后重新安装至C盘中。如果问题仍未解决，可以查看微软官方文档，尝试文档中提供的其他解决方法。

socket异常

若出现socket类型的错误，可以尝试重置网络环境。以管理员身份打开cmd终端，输入"netsh winsock reset"并按下回车执行，随后重新启动系统再次尝试。

白屏

如果进入直播间时出现白屏情况，可以在登录页时开启控制台，然后再进入直播间，检查控制台是否有错误信息输出。

加载美颜插件失败

若遇到如截图类似的错误即为加载美颜插件失败，可以参考以下方法解决。

• 方法一：建议从官网下载最新版本的安装包并进行重新安装。需要注意的是，这种方法可能只能解决白屏问题，但仍无法使用美颜功能。

• 方法二：建议检查应用的安装路径是否包含非英文字符（例如中文）。如果存在非英文字符的情况，建议先卸载该应用，然后重新安装至不包含非英文字符的路径下。

• 方法三：如果用户的系统缺少所需的系统库，用户需要自行进行安装。

  1. 打开设置，选择应用 > 应用和功能。

  2. 检查是否已安装了Microsoft Visual C++，通常会列出多个版本。如果缺少所需的版本，可以通过以下链接下载vc_redist.exe进行安装（我们程序是64位的，那就下载64位的即可）：https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170&viewFallbackFrom=msvc-170%E3%80%82

• 方法四：请下载附件sys_deps.zip，并在出现问题的设备上解压缩该压缩包。然后将压缩包中x64文件夹下的所有.dll文件复制到截图中显示的plugin/win/x64文件夹中，即与AliyunQueenPlugin.dll文件处于同一级目录。