使用Token鉴权

Token privilege

privilege 主要用于控制用户级别权限，主要支持以下权限控制：发送音频、发送视频、发送屏幕共享。

privilege的使用流程一般如下：

1. 申请token时，针对不同的用户，给不同的privilege参数

2. SDK在生成token时增加权限属性

3. SDK使用token与RTC交互，RTC校验token权限

4. 如果权限不足，则拒绝相关操作

在Token中有一个参数privilege用于传入权限信息。

privilege参数的值是16bits的数字，每个bit代表一种权限：

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            privilege              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

• bit0 为低位，bit0 值为1 时，表示启用权限控制，否则不控制权限，所有功能都放开

• bit1 表示是否可以发送音频

• bit2 表示是否可以发送视频

• bit3 表示是否可以发送屏幕共享

用法举例：

• privilege=0，不启用权限控制，允许所有能力

• privilege=3，二进制：0000 0000 0000 0011，表示可以发送音频，无其它权限

• privilege=5，二进制：0000 0000 0000 0101，表示可以发送视频，无其它权限

• privilege=7，二进制：0000 0000 0000 0111，表示可以发送音频和视频，无其它权限

具体用法示例，请见底部不同语言示例代码。

Token options

options定义了频道级别相关配置，用户可以自定义，具体用法可以参考文档底部不同语言示例代码。数值范围会受RTC服务校验，如有特殊需求请提交工单提高上限。

1. duration_per_channel

   • 字段含义：频道最大时长，单位为秒。

   • 取值区间：[300,86400]。

   • 默认值：86400 。

   • 其它补充：

     • token的过期时间不能超过当前时间加上频道时长之和。否则入会失败，请评估业务实际需要，按需设置。

     • 由于系统实现机制，可能和配置值有最大10s的偏差。

2. delay_close_per_channel

   • 字段含义：频道中没有人时，频道保留最大时长，单位为秒。

   • 取值区间：[1,86400]。

   • 默认值：60。

   • 其它补充：

     • 由于系统实现机制，可能和配置值有最大10s的偏差。