配置资源池流量额度
配置资源池流量额度
面向需要在子账号或设备通道维度限制播放流量的集成方。模型说明见 资源池额度管理；接口参数见 资源池额度管理 API。
适用场景与前提
- 已具备管理员 accessToken，并完成设备绑定与子账号授权（见 为我的用户创建子账号并分配设备）。
- 需要限制的场景包括 Open SDK、轻应用、直播地址或小程序中的音视频播放流量。
步骤
1. 创建资源池
调用 createResourcePool，指定：
resourceType：当前填flowquota：上限（MB）period：day、month或always
保存返回的 resourcePoolKey。
2. 绑定子账号或设备通道
按业务选择其一或组合使用：
| 目标 | 接口 |
|---|---|
| 限制某一子账号下所有播放 | bindSubAccountToResourcePool（openId 见 getOpenIdByAccount） |
| 限制某一路设备通道上的播放 | bindDeviceToResourcePool |
绑定约 5 分钟后，该主体播放时将计入对应池并校验上限。
3. 查询消耗与配置
| 需求 | 接口 |
|---|---|
| 查看单个池的配置与用量 | getResourcePool |
| 账号下全部资源池 | listResourcePoolByPage |
| 池内已绑子账号 / 通道 | listSubAccountResourcePoolConfigByPage / listDeviceResourcePoolConfigByPage |
| 某子账号或通道加入了哪些池 | getSubAccountResourcePoolConfig / getDeviceResourcePoolConfig |
4. 调整或下线
- 改额度或周期：modifyResourcePool（变更
period会清零已统计用量） - 解除绑定：unbindSubAccountFromResourcePool / unbindDeviceFromResourcePool
- 删除整个池：removeResourcePool
各端实现
资源池由服务端调用 OpenAPI 配置；客户端/SDK 侧无需额外参数。播放失败且返回 FL1008 / FL1009 时，提示用户流量已达上限，并在服务端用查询接口核对池用量。