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