抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

常见问题
收藏
我的收藏

异常处理

部分操作可能会产生错误,开发者需要对错误进行处理
​

初始化SDK

Initialize可能会抛出异常,此时表明直播SDK遇到了内部错误,开发者可以进行相关反馈。
​

初始化抖音云

重复初始化时会抛出InvalidOperationException。
初始化过程中抖音云内部会抛出其他异常,例如接口请求失败、Token 校验失败等,需要开发者提供重试机制。
​

抖音云短连接

HTTP 请求失败时抖音云 SDK 会做一些封装,抛出CustomException,需要开发者提供重试机制。
HTTP 响应返回 20X 以外的状态码时,也需要开发者处理。
​

抖音云长连接

Socket 状态不对时,会抛出InvalidOperationException,例如连接已经建立时再次尝试连接。
抖音云长连接建连失败时,可能会抛出抖音云内部的异常。
大部分错误会通过OnError事件传递。
​

直播间信息

直播 SDK 初始化后,直播间信息服务会自动请求本场直播的数据,并带有重试逻辑。
手动更新直播间数据时,UpdateRoomInfoAsync可能会抛出相关的 HTTP 错误。
​

构建打包

无需额外操作,插件会自动化工作。
注:构建产物中会自动拷贝放置一个 parfait_crash_handler.exe 程序,注意勿删除。需要一起打包发布到抖音小玩法控制台版本。
    •是 Unity 程序崩溃捕获程序,用途为平台方便排查问题、协助开发者、保障稳定性、提升用户体验质量。
​

初始化时默认加载 WebRTC,云机上启动崩溃

Q:接入 LiveOpenSDK 后,初始化会默认拉起一路 WebRTC,云机上直接崩溃,能否不启动?
A:该 WebRTC 并非玩法主动接入,而是云同步调试组件(CloudSync.Mock/FullMock)声明了 com.unity.webrtc 依赖,Unity 在启动时会自动初始化,SDK 侧没有开关能关闭。SDK 已准备「不含 Mock」的测试版本,请带着 bundleID(Unity 构建产物包名)联系对接同学获取并验证。
如果不使用云同步能力,即可删除目录 Packages/LiveOpenSDK/ByteDance.CloudSync (请使用 SDK 提供的「不含 Mock」版本,整目录删除,不要逐文件删 dll 和声明引用),删除后重新构建,确认启动日志中没有 Unity.WebRTC 初始化。
​