实时音视频 房间与媒体回调

一、配置信息

实时音视频 TRTC 控制台支持自助配置回调信息，配置完成后即可接收事件回调通知。详细操作指引请参见 回调配置。

注意：你需要提前准备以下信息：

二、超时重试

事件回调服务器在发送消息通知后，5秒内没有收到你的服务器的响应，即认为通知失败。首次通知失败后会立即重试，后续失败会以10秒的间隔继续重试，直到消息存续时间超过1分钟，不再重试。

三、事件回调消息格式

事件回调消息以 HTTP/HTTPS POST 请求发送给你的服务器，其中：

·字符编码格式：UTF-8。

·请求：body 格式为 JSON。

·应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容，为了协议友好，建议客户应答内容携带 JSON： {"code":0}。

四、回调消息参数

·事件回调消息的 header 中包含以下字段：

·事件回调消息的 body 中包含以下字段：

五、事件组 ID

注意：说明：

注意：录制事件组相关说明请参见 实现云端录制与回放。

六、事件类型

注意：退出房间只会回调104事件，不会回调202跟204事件。104事件相当于包含了202和204事件。手动关闭视频/音频，才会回调202/204事件。

七、事件回调示例

101102103104105201202203204205206{ "EventGroupId": 1, "EventType": 101, "CallbackTs": 1687770730166, "EventInfo": { "RoomId": 12345, "EventTs": 1687770730, "EventMsTs": 1687770730160, "UserId": "test" }}{ "EventGroupId": 1, "EventType": 102, "CallbackTs": 1687771618531, "EventInfo": { "RoomId": "12345", "EventTs": 1687771618, "EventMsTs": 1687771618457 }}{ "EventGroupId": 1, "EventType": 103, "CallbackTs": 1687770731932, "EventInfo": { "RoomId": 12345, "EventTs": 1687770731, "EventMsTs": 1687770731831, "UserId": "test", "Role": 21, "TerminalType": 2, "UserType": 3, "Reason": 1 }}{ "EventGroupId": 1, "EventType": 104, "CallbackTs": 1687770731922, "EventInfo": { "RoomId": 12345, "EventTs": 1687770731, "EventMsTs": 1687770731898, "UserId": "test", "Role": 20, "Reason": 1 }}{ "EventGroupId": 1, "EventType": 105, "CallbackTs": 1687772245596, "EventInfo": { "RoomId": 12345, "EventTs": 1687772245, "EventMsTs": 1687772245537, "UserId": "test", "Role": 21 }}{ "EventGroupId": 2, "EventType": 201, "CallbackTs": 1687771803198, "EventInfo": { "RoomId": 12345, "EventTs": 1687771803, "EventMsTs": 1687771803192, "UserId": "test" }}{ "EventGroupId": 2, "EventType": 202, "CallbackTs": 1687771919458, "EventInfo": { "RoomId": 12345, "EventTs": 1687771919, "EventMsTs": 1687771919447, "UserId": "test", "Reason": 0 }}{ "EventGroupId": 2, "EventType": 203, "CallbackTs": 1687771869377, "EventInfo": { "RoomId": 12345, "EventTs": 1687771869, "EventMsTs": 1687771869365, "UserId": "test" }}{ "EventGroupId": 2, "EventType": 204, "CallbackTs": 1687770732498, "EventInfo": { "RoomId": 12345, "EventTs": 1687770732, "EventMsTs": 1687770732383, "UserId": "test", "Reason": 0 }}{ "EventGroupId": 2, "EventType": 205, "CallbackTs": 1687772013823, "EventInfo": { "RoomId": 12345, "EventTs": 1687772013, "EventMsTs": 1687772013753, "UserId": "test" }}{ "EventGroupId": 2, "EventType": 206, "CallbackTs": 1687772015054, "EventInfo": { "RoomId": 12345, "EventTs": 1687772015, "EventMsTs": 1687772015032, "UserId": "test", "Reason": 0 }}

八、事件信息

注意：我们已发布“过滤客户端特殊行为导致的重复回调”策略。如果你是2021年07月30日之后接入回调服务，默认走新策略，房间事件组不再携带 UniqueId（唯一标识符）。

九、角色类型

十、终端类型

十一、用户类型

十二、具体原因

十三、计算签名

签名由 HMAC SHA256 加密算法计算得出，你的事件回调接收服务器收到回调消息后，通过同样的方式计算出签名，相同则说明是腾讯云的实时音视频的事件回调，没有被伪造。签名的计算如下所示：

//签名 Sign 计算公式中 key 为计算签名 Sign 用的加密密钥。Sign = base64（hmacsha256(key, body)）

注意：body 为你收到回调请求的原始包体，不要做任何转化，示例如下：

注意：body="{\\n\\t\\"EventGroupId\\":\\t1,\\n\\t\\"EventType\\":\\t103,\\n\\t\\"CallbackTs\\":\\t1615554923704,\\n\\t\\"EventInfo\\":\\t{\\n\\t\\t\\"RoomId\\":\\t12345,\\n\\t\\t\\"EventTs\\":\\t1608441737,\\n\\t\\t\\"UserId\\":\\t\\"test\\",\\n\\t\\t\\"UniqueId\\":\\t1615554922656,\\n\\t\\t\\"Role\\":\\t20,\\n\\t\\t\\"Reason\\":\\t1\\n\\t}\\n}"

十四、签名校验示例

JavaPythonPHPGolangimport javax.crypto.Mac;import javax.crypto.spec.SecretKeySpec;import java.util.Base64;//# 功能：第三方回调sign校验//# 参数：//# key：控制台配置的密钥key//# body：腾讯云回调返回的body体//# sign：腾讯云回调返回的签名值sign//# 返回值：//# Status：OK 表示校验通过，FAIL 表示校验失败，具体原因参考Info//# Info：成功/失败信息public class checkSign { public static String getResultSign(String key, String body) throws Exception { Mac hmacSha256 = Mac.getInstance("HmacSHA256"); SecretKeySpec secret_key = new SecretKeySpec(key.getBytes(), "HmacSHA256"); hmacSha256.init(secret_key); return Base64.getEncoder().encodeToString(hmacSha256.doFinal(body.getBytes())); } public static void main(String[] args) throws Exception { String key = "123654"; String body = "{\\n" + "\\t\\"EventGroupId\\":\\t2,\\n" + "\\t\\"EventType\\":\\t204,\\n" + "\\t\\"CallbackTs\\":\\t1664209748188,\\n" + "\\t\\"EventInfo\\":\\t{\\n" + "\\t\\t\\"RoomId\\":\\t8489,\\n" + "\\t\\t\\"EventTs\\":\\t1664209748,\\n" + "\\t\\t\\"EventMsTs\\":\\t1664209748180,\\n" + "\\t\\t\\"UserId\\":\\t\\"user_85034614\\",\\n" + "\\t\\t\\"Reason\\":\\t0\\n" + "\\t}\\n" + "}"; String Sign = "kkoFeO3Oh2ZHnjtg8tEAQhtXK16/KI05W3BQff8IvGA="; String resultSign = getResultSign(key, body); if (resultSign.equals(Sign)) { System.out.println("{'Status': 'OK', 'Info': '校验通过'}"); } else { System.out.println("{'Status': 'FAIL', 'Info': '校验失败'}"); } }}# -*- coding: utf8 -*-import hmacimport base64from hashlib import sha256# 功能：第三方回调sign校验# 参数：# key：控制台配置的密钥key# body：腾讯云回调返回的body体# sign：腾讯云回调返回的签名值sign# 返回值：# Status：OK 表示校验通过，FAIL 表示校验失败，具体原因参考Info# Info：成功/失败信息def checkSign(key, body, sign): temp_dict = {} computSign = base64.b64encode(hmac.new(key.encode('utf-8'), body.encode('utf-8'), digestmod=sha256).digest()).decode('utf-8') print(computSign) if computSign == sign: temp_dict['Status'] = 'OK' temp_dict['Info'] = '校验通过' return temp_dict else: temp_dict['Status'] = 'FAIL' temp_dict['Info'] = '校验失败' return temp_dictif __name__ == '__main__': key = '123654' body = "{\\n" + "\\t\\"EventGroupId\\":\\t2,\\n" + "\\t\\"EventType\\":\\t204,\\n" + "\\t\\"CallbackTs\\":\\t1664209748188,\\n" + "\\t\\"EventInfo\\":\\t{\\n" + "\\t\\t\\"RoomId\\":\\t8489,\\n" + "\\t\\t\\"EventTs\\":\\t1664209748,\\n" + "\\t\\t\\"EventMsTs\\":\\t1664209748180,\\n" + "\\t\\t\\"UserId\\":\\t\\"user_85034614\\",\\n" + "\\t\\t\\"Reason\\":\\t0\\n" + "\\t}\\n" + "}" sign = 'kkoFeO3Oh2ZHnjtg8tEAQhtXK16/KI05W3BQff8IvGA=' result = checkSign(key, body, sign) print(result)<?phpclass TlsEventSig { private $key = false; private $body = false; public function __construct( $key, $body ) { $this->key = $key; $this->body = $body; } private function __hmacsha256() { $hash = hash_hmac( 'sha256', $this->body, $this->key, true ); return base64_encode( $hash); } public function genEventSig() { return $this->__hmacsha256(); }}$key="789";$data="{\\n\\t\\"EventGroupId\\":\\t1,\\n\\t\\"EventType\\":\\t101,\\n\\t\\"CallbackTs\\":\\t1608086882372,\\n\\t\\"EventInfo\\":\\t{\\n\\t\\t\\"RoomId\\":\\t20222,\\n\\t\\t\\"EventTs\\":\\t1608086882,\\n\\t\\t\\"UserId\\":\\t\\"222222_phone\\"\\n\\t}\\n}";$api = new TlsEventSig($key, $data);echo $api->genEventSig();package mainimport "fmt"import ( "crypto/hmac" "crypto/sha256" "encoding/base64")func main () { var data = "{\\n\\t\\"EventGroupId\\":\\t1,\\n\\t\\"EventType\\":\\t101,\\n\\t\\"CallbackTs\\":\\t1608086882372,\\n\\t\\"EventInfo\\":\\t{\\n\\t\\t\\"RoomId\\":\\t20222,\\n\\t\\t\\"EventTs\\":\\t1608086882,\\n\\t\\t\\"UserId\\":\\t\\"222222_phone\\"\\n\\t}\\n}" var key = "789" fmt.Println(hmacsha256(data,key))}func hmacsha256(data string, key string) string { h := hmac.New(sha256.New, []byte(key)) h.Write([]byte(data)) return base64.StdEncoding.EncodeToString(h.Sum(nil))}