AgoraLiveTranscoding
- macOS
更新时间
媒体推流的转码配置。
__attribute__((visibility("default"))) @interface AgoraLiveTranscoding : NSObject
@property(copy, nonatomic) NSArray<AgoraLiveTranscodingUser*>* _Nullable transcodingUsers;
@property(assign, nonatomic) CGSize size;
@property(assign, nonatomic) NSInteger videoBitrate;
@property(assign, nonatomic) NSInteger videoFramerate;
@property(assign, nonatomic) BOOL lowLatency;
@property(assign, nonatomic) NSInteger videoGop;
@property(assign, nonatomic) AgoraVideoCodecProfileType videoCodecProfile;
@property(assign, nonatomic) AgoraVideoCodecTypeForStream videoCodecType;
@property(copy, nonatomic) NSString* _Nullable transcodingExtraInfo;
@property(copy, nonatomic) NSArray<AgoraImage*>* _Nullable watermarkArray;
@property(copy, nonatomic) NSArray<AgoraImage*>* _Nullable backgroundImageArray;
@property(strong, nonatomic) COLOR_CLASS* _Nullable backgroundColor;
@property(assign, nonatomic) AgoraAudioSampleRateType audioSampleRate;
@property(assign, nonatomic) NSInteger audioBitrate;
@property(assign, nonatomic) NSInteger audioChannels;
@property(assign, nonatomic) AgoraAudioCodecProfileType audioCodecProfile;
@end属性
| 参数名 | 描述 |
|---|---|
transcodingUsers | 媒体推流中的用户布局配置。最多支持添加 17 个转码用户。详见 AgoraLiveTranscodingUser。 |
size | 视频的尺寸(单位为像素)。
|
videoBitrate | 视频的编码码率(Kbps)。无需设置该参数,保持默认值 AgoraVideoBitrateStandard 即可。SDK 会根据你设置的视频分辨率和帧率自动匹配最合适的码率。分辨率与帧率的对应关系详见 |
videoFramerate | 媒体推流的视频输出帧率(fps)。默认值为 15,取值范围为 (0,30]。 注: 声网服务器会将超过 30 的值自动调整为 30。 |
lowLatency | 延迟模式:
|
videoGop | 媒体推流的视频帧的 GOP(图像组)帧率,单位为 fps。默认值为 30。 |
videoCodecProfile | 媒体推流的视频编解码器配置文件类型。可设置为 66、77 或 100(默认)。详见 AgoraVideoCodecProfileType。 注: 如果设置为其他值,声网会自动调整为默认值。 |
videoCodecType | 媒体推流的视频编解码器类型。详见 AgoraVideoCodecTypeForStream。 |
transcodingExtraInfo | 保留字段。用于通过 SEI 将用户自定义的额外信息发送到 CDN 直播客户端,适用于 H.264/H.265 视频流。最大长度为 4096 字节。 |
watermarkArray | 直播视频中的水印数组。你可以使用该属性添加一个或多个 PNG 格式的水印。直播视频中的水印和背景图总数必须在 0 到 10 之间。详见 AgoraImage。 |
backgroundImageArray | 直播视频中的背景图数组。你可以使用该属性添加一个或多个 PNG 格式的背景图。直播视频中的水印和背景图总数必须在 0 到 10 之间。详见 AgoraImage。 |
backgroundColor | 媒体推流的背景颜色。颜色格式为 RGB 十六进制整数,不带 # 符号,例如浅粉色为 0xFFB6C1,默认值为 0x000000(黑色)。COLOR_CLASS 是通用类型名:
|
audioSampleRate | 输出媒体流的音频采样率(Hz)。详见 AgoraAudioSampleRateType。 |
audioBitrate | 媒体推流的音频输出码率(Kbps)。默认值为 48,最大值为 128。 |
audioChannels | 媒体推流的音频声道数。推荐设置为 1(单声道)或 2(立体声)。如设置为 3、4 或 5,则需使用支持的播放器。
|
audioCodecProfile | 媒体推流的音频编解码器配置文件类型。详见 AgoraAudioCodecProfileType。 |