# 设置并更新 SEI 信息 (/zh-CN/realtime-media/media-push/build/configure-media-stream/set-sei) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 设置 SEI [#设置-sei] 本文介绍如何设置并更新用户 SEI(Supplemental Enhancement Information)信息。 在 `Create` 请求时,通过 `converter.transcodeOptions.videoOptions.seiOptions` 字段设置 SEI。 示例如下: ```json { "converter": { "name": "string", "transcodeOptions": { "rtcChannel": "string", "audioOptions": {}, "videoOptions": { // highlight-start "seiOptions": { "source": { "metadata": true, "datastream": false, "customized": {} }, "sink": { "type": 100 } }, // highlight-end "canvas": { "width": 100, "height": 100, "color": 0 }, "layoutType": 1, "vertical": { "maxResolutionUid": 3, "fillMode": "fill", "refreshIntervalSec": 3 }, "defaultPlaceholderImageUrl": "string", "bitrate": 30, "frameRate": 15, "gop": 30, "codec": "H.264", "codecProfile": "high" } }, "rtmpUrl": "rtmp://example/live/global" } } ``` ## 更新 SEI [#更新-sei] 在 `Update` 请求时,通过如下字段更新 SEI: - `seiOptions.source`:更新 SEI 信息的数据来源。 - `seiOptions.sink`:输出的 SEI 信息。 - `seiOptions`:更新 SEI 的所有配置。 更新时,请求 Body 中的 `source` 和 `sink` object 需要全量设置,不能仅设置 object 中的某个字段。 ### 示例一:更新 source [#示例一更新-source] 基于[设置 SEI](/zh-CN/realtime-media/media-push/build/configure-media-stream/set-sei) 示例,更新 `source`。例如将 `datastream` 更新为 `true`: ```json { "converter": { "transcodeOptions": { "videoOptions": { "seiOptions": { // highlight-start "source": { "metadata": true, "datastream": true, "customized": {} } // highlight-end } } } }, // highlight-start "fields": "transcodeOptions.videoOptions.seiOptions.source" // highlight-end } ``` ### 示例二:更新 sink [#示例二更新-sink] 基于[设置 SEI](/zh-CN/realtime-media/media-push/build/configure-media-stream/set-sei) 示例,更新 `sink`。例如将 `type` 更新为 `119`: ```json { "converter": { "transcodeOptions": { "videoOptions": { "seiOptions": { // highlight-start "sink": { "type": 119 } // highlight-end } } } }, // highlight-start "fields": "transcodeOptions.videoOptions.seiOptions.sink" // highlight-end } ``` ### 示例三:更新 source 和 sink [#示例三更新-source-和-sink] 基于[设置 SEI](/zh-CN/realtime-media/media-push/build/configure-media-stream/set-sei) 示例,同时更新 `source` 和 `sink`。例如将 `datastream` 更新为 `true` 且 `type` 更新为 `119`: ```json { "converter": { "transcodeOptions": { "videoOptions": { "seiOptions": { // highlight-start "source": { "metadata": true, "datastream": true, "customized": {} }, "sink": { "type": 119 } // highlight-end } } } }, // highlight-start "fields": "transcodeOptions.videoOptions.seiOptions" // highlight-end } ``` ## 特例:纯音频场景设置输出 SEI [#特例纯音频场景设置输出-sei] 在纯音频流(无视频)场景中,默认情况下无需设置 `videoOptions` 及其相关字段。但是如果你需要在音频流中携带用户的额外信息(例如音量),你可以通过 `videoOptions` 中的 `seiOptions` 字段设置 SEI 信息。 如果你想在纯音频场景下输出用户携带的 Metadata 或 DataStream 类型的 SEI 信息,而且不想被收取视频转码费用,那么你需要进行如下设置: - 在 `videoOptions.seiOptions` 中传入待输出的 SEI 信息。 - 确保 `videoOptions.canvas` 中的宽度和高度均设为 16,否则会产生视频转码费用。 - 在 `videoOptions.layout` 中将携带 SEI 信息的用户 ID 传入 `rtcStreamUid` 字段中。 ## API 参考 [#api-参考] 你可以参考 [`Create`](/zh-CN/api-reference/api-ref/media-push/create) 和 [`Update`](/zh-CN/api-reference/api-ref/media-push/update) 方法了解字段详情。