事件类型
110 cloud_transcoder_started
当你调用 Create 成功创建一个 cloud transcoder 时,消息通知服务器会向你的服务器通知创建成功事件。
eventType 为 110(cloud_transcoder_started),payload 示例如下:
{
"taskId":"1234",
"instanceId":"123",
"sequence":123,
"sendts":1656573243385,
"serviceScene":"rtsc/cloud-transcoder",
"details":{
"event":"cloud_transcoder_started",
"state":"Transcoder success",
"createTs":1658112464000,
"transcoder":{
"inputs":[
{
"rtcChannel":"test01",
"rtcUid":123,
"audio":true,
"video":false
},
{
"rtcChannel":"test01",
"rtcUid":456,
"audio":true,
"video":true
}
],
"outputs":[
{
"rtcChannel":"test01",
"rtcUid":1000,
"audio":true,
"video":true
}
],
"userConfigDetail":"{XXXX}"
}
}
}
字段解释:
taskId:String 型字段。任务 ID。它是声网服务器生成的一个 UUID(通用唯一识别码),标识一个已创建的 cloud transcoder。instanceId:String 型可选字段。调用Acquire时为本次云端转码指定的实例 ID。sequence:Number 类型,消息序列号,从 0 开始计数。消息可能乱序到达或者丢失重发,可以通过该参数标识消息。sendts:Number 类型, 事件发生的时间 (UTC 时间)。Unix 时间戳,精确到毫秒。serviceScene:服务场景。对于云端转码服务,值为"rtsc/cloud-transcoder"。details:JSON Object 型字段。消息内容。
details 包含如下字段:
-
event: String 型字段。回调事件类型。在该事件中为"cloud_transcoder_started",表示成功创建一个 cloud transcoder。 -
state: String 型字段,云端转码的状态。在该事件中为"Transcoder success",表示成功创建一个 cloud transcoder,开始云端转码。 -
createTs:Number 型字段。创建 cloud transcoder 时的 Unix 时间戳(秒)。 -
transcoder:JSON Object 型字段。Cloud transcoder 的输入和输出配置。-
inputs:JSON Array 型字段。Cloud transcoder 的音视频输入源配置。-
rtcChannel:String 型字段。音视频输入源所属的 RTC 频道名。 -
rtcUid:Number 型字段。音视频输入源所对应的 UID。 -
audio:Boolean 型字段。是否有音频输入源:-
true:有音频输入源。 -
false:无音频输入源。
-
-
video:Boolean 型字段。是否有视频输入源:-
true:有视频输入源。 -
false:无视频输入源。
-
-
-
outputs:JSON Array 型字段。Cloud transcoder 的音视频输出配置。-
rtcChannel:String 型字段。输出音视频所属的 RTC 频道名。 -
rtcUid:Number 型字段。输出音视频所对应的 UID。 -
audio:Boolean 型字段。是否有音频输出:-
true:有音频输出。 -
false:无音频输出。
-
-
video:Boolean 型字段。是否有视频输出:-
true:有视频输出。 -
false:无视频输出。
-
-
-
userConfigDetail:String 类型。Create请求包体中的cloudTranscoder.config。
-
113 cloud_transcoder_updated
当你调用 Update 成功更新一个 cloud transcoder 配置时,消息通知服务器会向你的服务器通知配置更新事件。
eventType 为 113(cloud_transcoder_updated)。
{
"taskId": "1234",
"instanceId": "123",
"sequence": 123,
"sendts": 1656573243385,
"serviceScene": "rtsc/cloud-transcoder",
"details": {
"event": "cloud_transcoder_updated",
"state": "running",
"createTs": 1658112464000,
"updateTs": 1658112464000,
"transcoder": {
"inputs": [
{
"rtcChannel": "test01",
"rtcUid": 123,
"audio": true,
"video": false
},
{
"rtcChannel": "test01",
"rtcUid": 456,
"audio": true,
"video": true
}
],
"outputs": [
{
"rtcChannel": "test01",
"rtcUid": 1000,
"audio": true,
"video": true
}
],
"userConfigDetail": "json_string"
}
}
}
字段解释:
taskId:String 型字段。任务 ID。它是声网服务器生成的一个 UUID(通用唯一识别码),标识一个已创建的 cloud transcoder。instanceId:String 型可选字段。调用Acquire时为本次云端转码指定的实例 ID。sequence:Number 类型,消息序列号,从 0 开始计数。消息可能乱序到达或者丢失重发,可以通过该参数标识消息。sendts:Number 类型, 事件发生的时间 (UTC 时间)。Unix 时间戳,精确到毫秒。serviceScene:服务场景。对于云端转码服务,值为"rtsc/cloud-transcoder"。details:JSON Object 型字段。消息内容。
details 包含如下字段:
-
event:String 型字段。回调事件类型。在该事件中为"cloud_transcoder_updated",表示 cloud transcoder 配置更新。 -
state:String 型字段,云端转码的状态。running表示 cloud transcoder 正常运行中,正在进行云端转码。 -
createTs:Number 型字段。创建 cloud transcoder 时的 Unix 时间戳(秒)。 -
updateTs:Number 型字段。更新 cloud transcoder 配置时的 Unix 时间戳(秒)。 -
userConfigDetail:String 类型。请求包体中的配置内容(cloudTranscoder.config)。 -
transcoder:JSON Object 型字段。Cloud transcoder 的输入和输出配置。-
inputs:JSON Array 型字段。Cloud transcoder 的音视频输入源配置。-
rtcChannel:String 型字段。音视频输入源所属的 RTC 频道名。 -
rtcUid:Number 型字段。音视频输入源所对应的 UID。 -
audio:Boolean 型字段。是否有音频输入源:-
true:有音频输入源。 -
false:无音频输入源。
-
-
video:Boolean 型字段。是否有视频输入源:-
true:有视频输入源。 -
false:无视频输入源。
-
-
-
outputs:JSON Object 型字段。Cloud transcoder 的音视频输出配置。-
rtcChannel:String 型字段。输出音视频所属的 RTC 频道名。 -
rtcUid:Number 型字段。输出音视频所对应的 UID。 -
audio:Boolean 型字段。是否有音频输出:-
true:有音频输出。 -
false:无音频输出。
-
-
video:Boolean 型字段。是否有视频输出:-
true:有视频输出。 -
false:无视频输出。
-
-
-
112 cloud_transcoder_status
成功创建一个 cloud transcoder 后,当 cloud transcoder 运行状态改变时,消息通知服务器会向你的服务器通知运行状态改变事件。
eventType 为 112(cloud_transcoder_status),payload 示例如下:
{
"taskId": "1234",
"instanceId": "123",
"sequence": 123,
"sendts": 1656573243385,
"serviceScene": "rtsc/cloud-transcoder",
"details": {
"event": "cloud_transcoder_status",
"state": "running",
"createTs": 1658112464000,
"updateTs": 1658112464000
}
}
字段解释:
taskId:String 型字段。任务 ID。它是声网服务器生成的一个 UUID(通用唯一识别码),标识一个已创建的 cloud transcoder。instanceId:String 型可选字段。调用Acquire时为本次云端转码指定的实例 ID。sequence:Number 类型,消息序列号,从 0 开始计数。消息可能乱序到达或者丢失重发,可以通过该参数标识消息。sendts:Number 类型, 事件发生的时间 (UTC 时间)。Unix 时间戳,精确到毫秒。serviceScene:服务场景。对于云端转码服务,值为"rtsc/cloud-transcoder"。details:JSON Object 型字段。消息内容。
details 包含如下字段:
-
event:String 型字段。回调事件类型。在该事件中为"cloud_transcoder_status",表示 cloud transcoder 运行状态改变。 -
state:String 型字段,云端转码的状态,可能为如下:-
connecting:正在连接声网业务服务器。 -
running:正常运行,正在进行云端转码。 -
failed:云端转码失败。
-
-
createTs:Number 型字段。创建 cloud transcoder 时的 Unix 时间戳(秒)。 -
updateTs:Number 型字段。更新 cloud transcoder 配置时的 Unix 时间戳(秒)。
111 cloud_transcoder_stopped
当一个 cloud transcoder 被销毁而停止云端转码时,消息通知服务器会向你的服务器通知销毁成功事件。
eventType 为 111(cloud_transcoder_stopped),payload 示例如下:
{
"taskId": "1234",
"instanceId": "123",
"sequence": 123,
"sendts": 1656573243385,
"serviceScene": "rtsc/cloud-transcoder",
"details": {
"event": "cloud_transcoder_stopped",
"stopReason": "Stop request",
"createTs": 1658112464000,
"updateTs": 1658112464000
}
}
字段解释:
taskId:String 型字段。任务 ID。它是声网服务器生成的一个 UUID(通用唯一识别码),标识一个已创建的 cloud transcoder。instanceId:String 型可选字段。调用Acquire时为本次云端转码指定的实例 ID。sequence:Number 类型,消息序列号,从 0 开始计数。消息可能乱序到达或者丢失重发,可以通过该参数标识消息。sendts:Number 类型, 事件发生的时间 (UTC 时间)。Unix 时间戳,精确到毫秒。serviceScene:服务场景。对于云端转码服务,值为"rtsc/cloud-transcoder"。details:JSON Object 型字段。消息内容。
details 包含如下字段:
-
event:String 型字段。回调事件类型。在该事件中为"cloud_transcoder_stopped",表示成功销毁一个 cloud transcoder。 -
stopReason:String 型字段,云端转码停止的原因,可能是因为你调用Delete,也可能是其他异常原因。你可以根据该字段排查云端转码异常停止的原因。 -
createTs:Number 型字段。创建 cloud transcoder 时的 Unix 时间戳(秒)。 -
updateTs:Number 型字段。更新 cloud transcoder 配置时的 Unix 时间戳(秒)。