# 自定义视频采集和渲染 (/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## createCustomVideoTrack [#createcustomvideotrack] 创建一个自定义视频轨道。 ```objc - (unsigned int)createCustomVideoTrack NS_SWIFT_NAME(createCustomVideoTrack()); ``` 要发布自定义视频源,请按照以下步骤操作: 1. 调用该方法创建一个视频轨道,并获取视频轨道 ID。 2. 调用 `joinChannelByToken` 加入频道。在 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/ios/class-channelmediaoptions) 中,将 `customVideoTrackId` 设置为你想要发布的视频轨道 ID,并将 `publishCustomVideoTrack` 设置为 YES。 3. 调用 `pushExternalVideoFrame`,并将 `videoTrackId` 设置为第 2 步中设置的视频轨道 ID,即可在频道中发布对应的自定义视频源。 ### 返回值 [#返回值] - 方法调用成功时,返回视频轨道 ID,作为该视频轨道的唯一标识符。 - 方法调用失败时,返回 `0xffffffff`。 ### 所属接口类 [#所属接口类] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## destroyCustomVideoTrack: [#destroycustomvideotrack] 销毁指定的视频轨道。 ```objc - (int)destroyCustomVideoTrack:(NSUInteger)videoTrackId NS_SWIFT_NAME(destroyCustomVideoTrack(_:)); ``` ### 参数 [#参数] 调用 [createCustomVideoTrack](/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering#api_irtcengine_createcustomvideotrack) 方法返回的视频轨道 ID。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## pushExternalVideoFrame\:videoTrackId: [#pushexternalvideoframevideotrackid] 通过视频轨道将外部原始视频帧推送到 SDK。 ```objc - (BOOL)pushExternalVideoFrame:(AgoraVideoFrame * _Nonnull)frame videoTrackId:(NSUInteger)videoTrackId NS_SWIFT_NAME(pushExternalVideoFrame(_:videoTrackId:)); ``` 要发布自定义视频源,请按照以下步骤操作: 1. 调用 [createCustomVideoTrack](/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering#api_irtcengine_createcustomvideotrack) 创建视频轨道并获取视频轨道 ID。 2. 调用 `joinChannelByToken` 加入频道。在 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/ios/class-channelmediaoptions) 中,将 `customVideoTrackId` 设置为要发布的视频轨道 ID,并将 `publishCustomVideoTrack` 设置为 YES。 3. 调用 [pushExternalVideoFrame\:videoTrackId:](/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe) 方法,并将 `videoTrackId` 指定为第 2 步中设置的视频轨道 ID,即可在频道中发布相应的自定义视频源。 ### 参数 [#参数-1] 要推送的外部原始视频帧。详见 [AgoraVideoFrame](/zh-CN/api-reference/rtc/ios/class-externalvideoframe)。 通过调用 [createCustomVideoTrack](/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering#api_irtcengine_createcustomvideotrack) 方法返回的视频轨道 ID。 - 如果你只需推送一个自定义视频源,请将该参数设置为 0。 ### 返回值 [#返回值-2] - YES:推送外部视频帧成功。 - NO:推送外部视频帧失败。 ### 所属接口类 [#所属接口类-2] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## pushExternalVideoFrame: [#pushexternalvideoframe] 将外部原始视频帧推送到 SDK。 ```objc - (BOOL)pushExternalVideoFrame:(AgoraVideoFrame * _Nonnull)frame NS_SWIFT_NAME(pushExternalVideoFrame(_:)) __deprecated_msg("use pushExternalVideoFrame:frame,videoTrackId options instead."); ``` :::error[废弃] 该方法已废弃,请改用 `pushExternalVideoFrame:frame,videoTrackId`。 ::: 调用 [setExternalVideoSource\:useTexture\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering#api_irtcengine_setexternalvideosource) 方法,并将 `enabled` 参数设置为 YES,`encodedFrame` 参数设置为 NO 后,可以调用该方法将外部原始视频帧推送到 SDK。 ### 参数 [#参数-2] 要推送的外部原始视频帧。详见 [AgoraVideoFrame](/zh-CN/api-reference/rtc/ios/class-externalvideoframe)。 ### 返回值 [#返回值-3] - YES:方法调用成功。 - NO:方法调用失败。 ### 所属接口类 [#所属接口类-3] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## setExternalVideoSource\:useTexture\:sourceType: [#setexternalvideosourceusetexturesourcetype] 配置外部视频源。 ```objc - (void)setExternalVideoSource:(BOOL)enable useTexture:(BOOL)useTexture sourceType:(AgoraExternalVideoSourceType)sourceType NS_SWIFT_NAME(setExternalVideoSource(_:useTexture:sourceType:)); ``` 调用该方法启用外部视频源后,可以调用 [pushExternalVideoFrame\:videoTrackId:](/zh-CN/api-reference/rtc/ios/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe) 方法将外部视频数据推送到 SDK。 :::note 注: 频道内不支持动态切换视频源。如需从外部视频源切换为内部视频源,必须先离开频道,调用该方法关闭外部视频源,再重新加入频道。 ::: ### 调用时机 [#调用时机] 该方法需要在加入频道前调用。 ### 参数 [#参数-3] 是否使用外部视频源: - YES:使用外部视频源,SDK 准备接收外部视频帧。 - NO:(默认)不使用外部视频源。 是否使用 Texture 格式的外部视频帧: - YES:使用 Texture 格式的外部视频帧。 - NO:(默认)不使用 Texture 格式的外部视频帧。 外部视频帧的类型,详见 [AgoraExternalVideoSourceType](/zh-CN/api-reference/rtc/ios/enum-externalvideosourcetype)。 ### 所属接口类 [#所属接口类-4] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)