事件类型
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 时间戳(秒)。