登录鉴权

更新时间：2026-10-29 10:05:40

专属版不需要手机号、邮箱或密码登录，而是使用专属版平台颁发的 authToken 完成鉴权。只有鉴权成功后，才能调用云回看、存储卡、设备控制等专属版接口。

// 导入账号管理头文件
import { RTCXAccount } from 'rtcxsdk'

相关接口

/**
 * 专属版 authToken 登录
 *
 * @param authToken - 专属版登录 token
 * @public
 */
export declare function authenticateSpecialToken(authToken: string): Promise<void>;

/**
 * 专属版登出，清空 authToken 并断开专属信令通道
 * @public
 */
export declare function invalidateSpecialAuthToken(): Promise<void>;

authToken 鉴权

authToken 由专属版平台或自有业务服务签发，不是通用版的登录 token，也不能使用通用版的账号密码登录接口获取。

try {
  await RTCXAccount.authenticateSpecialToken(authToken)
  showToast(this, '登录成功')
  this.pathStack.replacePathByName('PageMain', null)
} catch (e) {
  showToast(this, `登录失败[${e.code ?? e.message}]`)
} finally {
  hideLoading()
}

鉴权成功后，SDK 会：

1. 保存专属版 authToken，后续专属版网关请求使用该 token 鉴权；
2. 通知专属版信令通道建立连接；
3. 预拉取专属版 region 列表，预拉取失败不会阻塞登录。

退出登录

RTCXAccount.invalidateSpecialAuthToken()

调用后会清空专属版 authToken，并断开专属版信令通道。

注意事项

• 专属版不支持 loginByPassword、loginByVerifyCode 等通用版账号登录接口，这些接口仅用于通用版账号体系。
• 调用 authenticateSpecialToken 前，需要先使用 specialAppKeyConfig 完成 SDK 初始化，否则会抛出未初始化异常；传入空的 authToken 也会抛出参数异常。
• authToken 失效或过期后，云回看、存储卡、设备控制等接口会返回鉴权错误，需要重新获取 authToken 后再次调用 authenticateSpecialToken。
• 专属版 authToken 由 APP 自行缓存。APP 启动时可读取本地缓存的 authToken 重新鉴权，不需要用户再次输入账号密码。
• 通用版与专属版可以同时登录，两种登录入口互不影响。但调用通用版 logout() 会清空本地全部登录态（包括专属版 authToken）；如果只想退出专属版，请调用 invalidateSpecialAuthToken()。