# FLiveTranscoding (/zh-CN/api-reference/rtc/unreal-blueprint/class-livetranscoding) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```cpp USTRUCT(BlueprintType) struct FLiveTranscoding { GENERATED_BODY() public: UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int width = 360; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int height = 640; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int videoBitrate = 400; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int videoFramerate = 15; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") bool lowLatency = false; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int videoGop = 30; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") EVIDEO_CODEC_PROFILE_TYPE videoCodecProfile = EVIDEO_CODEC_PROFILE_TYPE::VIDEO_CODEC_PROFILE_HIGH; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int64 backgroundColor = 0x000000; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") EVIDEO_CODEC_TYPE_FOR_STREAM videoCodecType = EVIDEO_CODEC_TYPE_FOR_STREAM::VIDEO_CODEC_H264_FOR_STREAM; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int userCount = 0; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") TArray transcodingUsers; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") FString transcodingExtraInfo = ""; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") FString metadata = ""; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") TArray watermark; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int watermarkCount = 0; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") TArray backgroundImage; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int backgroundImageCount = 0; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") EAUDIO_SAMPLE_RATE_TYPE audioSampleRate = EAUDIO_SAMPLE_RATE_TYPE::AUDIO_SAMPLE_RATE_48000; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int audioBitrate = 48; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int audioChannels = 1; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") EAUDIO_CODEC_PROFILE_TYPE audioCodecProfile = EAUDIO_CODEC_PROFILE_TYPE::AUDIO_CODEC_PROFILE_LC_AAC; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") TArray advancedFeatures; UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|LiveTranscoding") int advancedFeatureCount = 0; FLiveTranscoding(){} FLiveTranscoding(const agora::rtc::LiveTranscoding & AgoraData){ width = AgoraData.width; height = AgoraData.height; videoBitrate = AgoraData.videoBitrate; videoFramerate = AgoraData.videoFramerate; lowLatency = AgoraData.lowLatency; videoGop = AgoraData.videoGop; videoCodecProfile = static_cast(AgoraData.videoCodecProfile); backgroundColor = AgoraData.backgroundColor; videoCodecType = static_cast(AgoraData.videoCodecType); userCount = AgoraData.userCount; for(int i = 0; i< userCount; i++){ transcodingUsers.Add(FTranscodingUser((AgoraData.transcodingUsers[i]))); } transcodingExtraInfo = UTF8_TO_TCHAR(AgoraData.transcodingExtraInfo); metadata = UTF8_TO_TCHAR(AgoraData.metadata); for(unsigned int i =0; i< AgoraData.watermarkCount;i++) { watermark.Add(FRtcImage(AgoraData.watermark[i])); } watermarkCount = AgoraData.watermarkCount; for(unsigned int i =0; i< AgoraData.backgroundImageCount;i++){ backgroundImage.Add(FRtcImage(AgoraData.watermark[i])); } backgroundImageCount = AgoraData.backgroundImageCount; audioSampleRate = static_cast(AgoraData.audioSampleRate); audioBitrate = AgoraData.audioBitrate; audioChannels = AgoraData.audioChannels; audioCodecProfile = static_cast(AgoraData.audioCodecProfile); for(unsigned int i = 0; i< AgoraData.advancedFeatureCount; i++){ advancedFeatures.Add(FLiveStreamAdvancedFeature(AgoraData.advancedFeatures[i])); } advancedFeatureCount = AgoraData.advancedFeatureCount; } agora::rtc::LiveTranscoding CreateAgoraData() const { agora::rtc::LiveTranscoding AgoraData; AgoraData.width = width; AgoraData.height = height; AgoraData.videoBitrate = videoBitrate; AgoraData.videoFramerate = videoFramerate; AgoraData.lowLatency = lowLatency; AgoraData.videoGop = videoGop; AgoraData.videoCodecProfile = static_cast(videoCodecProfile); AgoraData.backgroundColor = static_cast(backgroundColor); AgoraData.videoCodecType = static_cast(videoCodecType); AgoraData.userCount = userCount; SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMALLOC(AgoraData.transcodingUsers, agora::rtc::TranscodingUser, userCount, this->transcodingUsers) SET_UABT_FSTRING_TO_CONST_CHAR___MEMALLOC(AgoraData.transcodingExtraInfo,this->transcodingExtraInfo) SET_UABT_FSTRING_TO_CONST_CHAR___MEMALLOC(AgoraData.metadata,this->metadata) AgoraData.watermarkCount = watermarkCount; SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMALLOC(AgoraData.watermark, agora::rtc::RtcImage, watermarkCount, this->watermark) AgoraData.backgroundImageCount = backgroundImageCount; SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMALLOC(AgoraData.backgroundImage, agora::rtc::RtcImage, backgroundImageCount, this->backgroundImage) AgoraData.audioSampleRate = static_cast(audioSampleRate); AgoraData.audioBitrate = audioBitrate; AgoraData.audioChannels = audioChannels; AgoraData.advancedFeatureCount = advancedFeatureCount; SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMALLOC(AgoraData.advancedFeatures,agora::rtc::LiveStreamAdvancedFeature, advancedFeatureCount,this->advancedFeatures) return AgoraData; } void FreeAgoraData(agora::rtc::LiveTranscoding & AgoraData) const{ SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMFREE(AgoraData.transcodingUsers,userCount, FTranscodingUser) SET_UABT_FSTRING_TO_CONST_CHAR___MEMFREE(AgoraData.transcodingExtraInfo) SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMFREE(AgoraData.watermark, watermarkCount, FRtcImage) SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMFREE(AgoraData.backgroundImage, backgroundImageCount, FRtcImage) SET_UABT_TARRARY_CUSTOMDATA_TO_AGORA_ARRAY___MEMFREE(AgoraData.advancedFeatures, advancedFeatureCount, FLiveStreamAdvancedFeature) } }; ``` ## 属性 [#属性] 推流视频的总宽度,默认值 360,单位为像素。 - 如果推视频流,`width` 取值范围为 [64,1920]。如果取值低于 64,声网服务器会自动调整为 64; 如果取值高于 1920,声网服务器会自动调整为 1920。 - 如果推音频流,请将 `width` 和 `height` 设为 0。 推流视频的总高度,默认值 640,单位为像素。 - 如果推视频流,`height` 取值范围为 [64,1080]。如果取值低于 64,声网服务器会自动调整为 64; 如果取值高于 1080,声网服务器会自动调整为 1080。 - 如果推音频流,请将 `width` 和 `height` 设为 0。 视频编码码率,单位为 Kbps。该参数无需设置,保留默认值 STANDARD_BITRATE 即可,SDK 会根据你设定的视频分辨率和帧率自动匹配最合适的码率。有关视频分辨率和帧率的对应关系,详见[视频属性](/zh-CN/realtime-media/rtc/build/video/video-profile)。 用于旁路直播的输出视频的帧率。取值范围是 (0,30],单位为 fps。15 fps 为默认值。 :::caution 注意: 声网服务器会将高于 30 fps 的帧率统一调整为 30 fps。 ::: :::error[弃用] 不建议使用。 ::: 低延时模式 - `true`: 低延时,不保证画质。 - `false`:(默认值)高延时,保证画质。 用于旁路直播的输出视频的 GOP (Group of Pictures)。单位为帧。默认值为 30。 用于旁路直播的输出视频的编码规格。可以设置为 66、77 或 100,详见 [EVIDEO_CODEC_PROFILE_TYPE](/zh-CN/api-reference/rtc/unreal-blueprint/enum-videocodecprofiletype)。 :::caution 注意: 如果你把这个参数设为其他值,声网服务器会将其调整为默认值。 ::: 用于旁路直播的输出视频的编解码类型。详见 [EVIDEO_CODEC_TYPE_FOR_STREAM](/zh-CN/api-reference/rtc/unreal-blueprint/enum-videocodectypeforstream)。 用于管理参与旁路直播的视频转码合图的用户。最多支持 17 人同时参与转码合图。详见 [FTranscodingUser](/zh-CN/api-reference/rtc/unreal-blueprint/class-transcodinguser)。 预留参数:用户自定义的发送到旁路推流客户端的信息,用于填充 H264/H265 视频中 SEI 帧内容。长度限制:4096 字节。关于 SEI 的详细信息,详见 [SEI 帧相关问题](/zh-CN/reference/faq/quality/sei)。 用于旁路直播的输出视频的背景色,格式为 RGB 定义下的十六进制整数,不要带 # 号,如 0xFFB6C1 表示浅粉色。默认0x000000,黑色。 参与合图的用户数量,默认 0。取值范围为 [0,17]。 :::error[弃用] 已废弃,不建议使用。 ::: 发送给 CDN 客户端的 metadata。 直播视频上的水印。图片格式需为 PNG。详见 [FRtcImage](/zh-CN/api-reference/rtc/unreal-blueprint/class-rtcimage)。 你可以添加一个水印,或使用数组的方式添加多个水印。该参数与 watermarkCount搭配使用。 直播视频上的背景图。图片格式需为 PNG。详见 [FRtcImage](/zh-CN/api-reference/rtc/unreal-blueprint/class-rtcimage)。 你可以添加一张背景图,或使用数组的方式添加多张背景图。该参数与 backgroundImageCount 搭配使用。 用于旁路推流的输出媒体流的音频采样率 (Hz),详见 [EAUDIO_SAMPLE_RATE_TYPE](/zh-CN/api-reference/rtc/unreal-blueprint/enum-audiosampleratetype)。 用于旁路直播的输出音频的码率。单位为 Kbps,默认值为 48,最大值为 128。 用于旁路直播的输出音频的声道数,默认值为 1。取值范围为 [1,5] 中的整型,建议取 1 或 2。3、4、5 需要特殊播放器支持: - 1: (默认)单声道 - 2: 双声道 - 3: 三声道 - 4: 四声道 - 5: 五声道 用于旁路直播输出音频的编码规格。详见 [EAUDIO_CODEC_PROFILE_TYPE](/zh-CN/api-reference/rtc/unreal-blueprint/enum-audiocodecprofiletype)。 直播视频上的水印的数量。水印和背景图的总数量需大于等于 0 且小于等于 10。该参数与 watermark 搭配使用。 直播视频上的背景图的数量。水印和背景图的总数量需大于等于 0 且小于等于 10。该参数与 backgroundImage 搭配使用。 转码推流的高级功能。详见 [FLiveStreamAdvancedFeature](/zh-CN/api-reference/rtc/unreal-blueprint/class-livestreamadvancedfeature)。 开启的高级功能数量。默认值为 0。