# VideoFrameSender 类 (/zh-CN/api-reference/rtc-server-sdk/go-api/videoframesender.go) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). `VideoFrameSender` 类 ## NewVideoFrameSender [#newvideoframesender] ```go func (mediaNodeFactory *MediaNodeFactory) NewVideoFrameSender() *VideoFrameSender { sender := C.agora_media_node_factory_create_video_frame_sender(mediaNodeFactory.cFactory) if sender == nil { return nil } return &VideoFrameSender{ cSender: sender, } } ``` 创建一个原始视频数据发送模块。该方法创建一个 `VideoFrameSender` 对象,可用于 [`NewCustomVideoTrackFrame`](/zh-CN/api-reference/rtc-server-sdk/go-api/localvideotrack.go#newcustomvideotrackframe) 方法。 #### 返回值 [#返回值] - `VideoFrameSender` 对象:方法调用成功。 - `nil`: 方法调用失败。 ## SendVideoFrame [#sendvideoframe] ```go func (sender *VideoFrameSender) SendVideoFrame(frame *ExternalVideoFrame) int { cData := C.CBytes(frame.Buffer) defer C.free(cData) cFrame := C.struct__external_video_frame{} C.memset(unsafe.Pointer(&cFrame), 0, C.sizeof_struct__external_video_frame) cFrame._type = C.int(frame.Type) cFrame.format = C.int(frame.Format) cFrame.buffer = cData cFrame.stride = C.int(frame.Stride) cFrame.height = C.int(frame.Height) cFrame.crop_left = C.int(frame.CropLeft) cFrame.crop_top = C.int(frame.CropTop) cFrame.crop_right = C.int(frame.CropRight) cFrame.crop_bottom = C.int(frame.CropBottom) cFrame.rotation = C.int(frame.Rotation) cFrame.timestamp = C.longlong(frame.Timestamp) if frame.MetadataBuffer != nil { metadata := C.CBytes(frame.MetadataBuffer) defer C.free(metadata) cFrame.metadata_buffer = (*C.uint8_t)(metadata) cFrame.metadata_size = C.int(len(frame.MetadataBuffer)) } if frame.AlphaBuffer != nil { alpha, alphaPinner := unsafeCBytes(frame.AlphaBuffer) defer alphaPinner.Unpin() cFrame.alpha_buffer = (*C.uint8_t)(alpha) } if frame.FillAlphaBuffer { cFrame.fill_alpha_buffer = C.uint8_t(1) } cFrame.alpha_mode = C.int(frame.AlphaMode) // fill color space: for go,the default value of struct 's member is zero value! cFrame.color_space.matrix_id = C.int(frame.ColorSpace.MatrixId) cFrame.color_space.primaries_id = C.int(frame.ColorSpace.PrimariesId) cFrame.color_space.transfer_id = C.int(frame.ColorSpace.TransferId) cFrame.color_space.range_id = C.int(frame.ColorSpace.RangeId) return int(C.agora_video_frame_sender_send(sender.cSender, &cFrame)) } ``` 将 YUV 格式的视频帧发送到视频轨道。 #### 参数 [#参数] | 参数 | 描述 | |------|------| | `frame` | 需要发送的视频帧,详见 [`ExternalVideoFrame`](/zh-CN/api-reference/rtc-server-sdk/go-api/apidatatype.go#externalvideoframe)。 | #### 返回值 [#返回值-1] - 0: 方法调用成功。 - < 0: 方法调用失败。