文档中心

实时音视频

请输入

集成相关

Token 使用常见问题

Token 是什么？

Token 是用户进房必须传入的参数，用于 RTC 服务端鉴权。

Token 在什么情况下需要使用？

每个用户在进房时都需要携带 Token 进行鉴权。

测试阶段是否必须使用 Token？如何获取？

测试阶段需要使用 Token。你可以在火山引擎控制台生成临时 Token，也可以参考火山引擎提供的 Token 生成示例代码在本地生成测试 Token。详情参看使用 Token 完成鉴权。

注意：在正式上线前，你需要把生成 Token 的逻辑集成到业务服务端，通过服务端下发 Token 给用户用于进房。

调用 joinRoom 后 onRoomStateChanged 回调收到 -1000 错误码？

只有当 onRoomStateChanged 返回 state=0 时才代表进房成功，其他情况都表示进房失败。-1000 错误码代表 Token 错误，可以重点检查以下几项：

创建 RTC 引擎时传入的 appId，以及 joinRoom 传入的 roomid、userid，是否与生成 Token 时使用的 appId、roomid、userid 一致。

如果 appId 和密钥不匹配，即使 Token 生成成功，进房时也会因 Token 无效而触发 onRoomStateChanged 回调并返回 -1000。

Token 的最长有效期是多久？

如果生成 Token 时未设置有效期，则 Token 永久有效。

进房后一段时间 Token 过期会被踢出房间吗？

会。Token 过期前 30 s，客户端会收到 onTokenWillExpire 回调。此时需要客户端调用 updateToke 传入新的未过期 Token，用户才能继续音视频互动，否则将被强制退出房间。

Token 过期被踢出房间，服务端会收到回调吗？

会。以可见用户为例，因 Token 过期被踢出房间后，服务端会收到 UserLeaveRoom 事件回调，reason 为 onUserTokenDidExpire。

最近更新时间：2026.09.28 09:46:49

这个页面对您有帮助吗？

有用

无用