RTC 頻道管理
應用詳情中的“RTC 頻道”用於管理獨立的音影片頻道,與“音影片”中的單聊、群通話分開。業務接入見頻道概述。
開通條件
要使用頻道,需要同時滿足:
- 應用開啟了音影片策略;
- 平臺的頻道總開關已開啟,並且沒有單獨關閉這個應用的頻道;
- 新計費模式下,本應用有正的音影片時長餘額;切換之前按套餐的音影片許可權判斷。給其他應用充值、或給本應用充值套餐資金,都不能代替音影片餘額。
總開關、應用開關和頻道數量上限由平臺管理。關閉頻道開關後,新建頻道、加入頻道和簽發票據都會被拒絕;已經在頻道中的會話仍可以按規則傳送心跳、續期憑據和退出。但應用變為只讀、關閉了策略或不再滿足媒體准入條件時,不能保證續期成功。需要立即結束某個頻道時,請點選“關閉”,並等待媒體清理完成。
許可權與操作
| 操作 | developer | admin / owner |
|---|---|---|
| 查詢頻道、會話、有效的封禁、統計和用量更正 | 可以 | 可以 |
| 建立、修改、關閉頻道,簽發票據,移出、封禁、解封成員 | 不可以 | 可以 |
寫操作同樣需要控制檯的身份驗證,並記入操作日誌;對應的介面見頻道管理,頁面上實際顯示哪些按鈕以當前頁面為準。控制檯不能替使用者領取加入頻道的媒體令牌。
查詢與處置
- 按狀態(
open進行中、closing關閉中、closed已關閉)篩選頻道,檢視名稱、媒體型別、容量、已佔用的席位和最近的媒體線上狀態。 - 開啟頻道詳情檢視當前的會話;已經退出的會話用
left篩選。會話保留 90 天。 - “移出”結束這個成員當前的會話,之後他還可以重新加入;“封禁”撤銷他還沒有使用的票據並開始移出,之後不能再加入。
- 解封時要使用最新的封禁版本,以免舊的請求解除了新的封禁;解封不會恢復之前的票據。
- 關閉後狀態先變為
closing,表示不再允許加入、清理還沒有完成;清理完成後變為closed,頻道不能重新開啟。
media_state 為 unknown 或 media_connected 為 null 表示暫時不知道媒體是否線上,不代表已經離線。seat_count 包含預留的席位和正在退出的席位,所以不能用成員列表的長度或線上人數代替已佔用的席位數。
統計與更正
日統計分為已定稿、暫定和還沒有彙總三種;還沒有彙總的不能當作 0。用量更正顯示提出的版本、已確認的版本、已確認和目標用量,以及登記憑證;confirmed 表示計費已經接收了這次更正,不代表已經出賬或結清。詳見用量與更正。
平臺後臺的“音影片 → RTC 頻道總覽”提供跨應用的總覽和頻道總開關;超級管理員重新驗證身份後可以直接修改總開關,設定在重啟後仍然保留。單個應用的開關在“IM 資料 → 音視訊通話”中。在跨應用總覽中可以按租戶、應用和狀態找到頻道,再進入應用詳情處理。租戶控制檯只能檢視自己的應用。
日統計和餘額如何核對
本頁的統計描述的是頻道的參與情況、定稿和歷史更正。新計費模式按每個接收者實際接收的影片解析度合計後折算,頻道和通話共用本應用每月的標準時長餘額;影片頻道中沒有接收影片的秒數按音訊計算,不會因為頻道的媒體型別是影片就固定按影片係數計費。詳見音影片計費。
