腾讯云实时音视频房间与媒体回调_音视频解决方案_同尘科技

事件回调服务支持将实时音视频业务下的事件，以 HTTP/HTTPS 请求的形式通知到您的服务器。事件回调服务已集成房间事件组（Room Event）和媒体事件组（Media Event），您可以向腾讯云提供相关的配置信息来开通该服务。

配置信息

实时音视频 TRTC 控制台支持自助配置回调信息，配置完成后即可接收事件回调通知。详细操作指引请参见 回调配置。
注意：您需要提前准备以下信息：必要项：接收回调通知的 HTTP/HTTPS 服务器地址。可选项：计算签名的密钥 key，由您自定义一个最大32个字符的 key，以大小写字母及数字组成。

超时重试

事件回调服务器在发送消息通知后，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}"

签名校验示例

JavaPythonPHPGolang

import 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_dict
if __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)



<?php
class 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"
    //JSRUN引擎2.0，支持多达30种语言在线运行，全仿真在线交互输入输出。    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))}



对音视频的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案