# 事件类型 (/zh-CN/api-reference/api-ref/cloud-transcoding/ncs-events) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 110 cloud_transcoder_started [#110-cloud_transcoder_started] 当你调用 [`Create`](/zh-CN/api-reference/api-ref/cloud-transcoding/create) 成功创建一个 cloud transcoder 时，消息通知服务器会向你的服务器通知创建成功事件。 `eventType` 为 110(`cloud_transcoder_started`)，`payload` 示例如下： ```json { "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`](/zh-CN/api-reference/api-ref/cloud-transcoding/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 型字段。输出音视频所对应的用户 ID。 - `audio`：Boolean 型字段。是否有音频输出： - `true`：有音频输出。 - `false`：无音频输出。 - `video`：Boolean 型字段。是否有视频输出： - `true`：有视频输出。 - `false`：无视频输出。 - `userConfigDetail`：String 类型。`Create` 请求包体中的 `cloudTranscoder.config`。 ## 113 cloud_transcoder_updated [#113-cloud_transcoder_updated] 当你调用 [`Update`](/zh-CN/api-reference/api-ref/cloud-transcoding/update) 成功更新一个 cloud transcoder 配置时，消息通知服务器会向你的服务器通知配置更新事件。 `eventType` 为 113(`cloud_transcoder_updated`)。 ```json { "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`](/zh-CN/api-reference/api-ref/cloud-transcoding/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 型字段。输出音视频所对应的用户 ID。 - `audio`：Boolean 型字段。是否有音频输出： - `true`：有音频输出。 - `false`：无音频输出。 - `video`：Boolean 型字段。是否有视频输出： - `true`：有视频输出。 - `false`：无视频输出。 ## 112 cloud_transcoder_status [#112-cloud_transcoder_status] 成功创建一个 cloud transcoder 后，当 cloud transcoder 运行状态改变时，消息通知服务器会向你的服务器通知运行状态改变事件。 `eventType` 为 112(`cloud_transcoder_status`)，`payload` 示例如下： ```json { "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`](/zh-CN/api-reference/api-ref/cloud-transcoding/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 [#111-cloud_transcoder_stopped] 当一个 cloud transcoder 被销毁而停止云端转码时，消息通知服务器会向你的服务器通知销毁成功事件。 `eventType` 为 111(`cloud_transcoder_stopped`)，`payload` 示例如下： ```json { "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`](/zh-CN/api-reference/api-ref/cloud-transcoding/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`](/zh-CN/api-reference/api-ref/cloud-transcoding/destroy)，也可能是其他异常原因。你可以根据该字段排查云端转码异常停止的原因。 - `createTs`：Number 型字段。创建 cloud transcoder 时的 Unix 时间戳（秒）。 - `updateTs`：Number 型字段。更新 cloud transcoder 配置时的 Unix 时间戳（秒）。