AgoraScreenVideoParameters Class Reference

Inherits from NSObject
Declared in AgoraObjects.h

Overview

共享的屏幕流的视频编码配置。

仅适用于 captureVideoYES 的场景。

  dimensions

视频编码的分辨率。默认值为 1280 × 720。推荐取值可参考调参策略

@property (assign, nonatomic) CGSize dimensions

Discussion

如果 dimensions 宽高比与屏幕像素值的宽高比不一致,SDK 会按照如下规则调节视频编码分辨率,以 dimensions 是 1280 × 720 为例:

  • 当屏幕宽和高的像素值均小于 dimensions 时,例如屏幕像素值为 640 × 360,SDK 以 640 × 360 编码。
  • 当屏幕宽或高的像素值大于 dimensions 时,例如屏幕像素值为 2000 × 1500,SDK 以屏幕像素值的宽高比,即 4:3,取 dimensions 内最大分辨率进行编码,即 960 × 720。

Note:

  • 屏幕共享流的计费以 dimensions 的值为准:当你未传值时,以 1280 × 720 计费;当你传值时,以你传入的值计费。详细的计费规则请参考实时音视频计费
  • 该值不代表最终视频输出的方向。请查阅 AgoraVideoOutputOrientationMode 了解设置视频方向。
  • 视频能否达到 720P 的分辨率取决于设备的性能,在性能配备较低的设备上有可能无法实现。如果采用 720P 分辨率而设备性能跟不上,则有可能出现帧率过低的情况。

Declared In

AgoraObjects.h

  frameRate

视频编码帧率 (fps)。默认值为 15。推荐取值可参考调参策略

@property (assign, nonatomic) NSInteger frameRate

Declared In

AgoraObjects.h

  bitrate

视频编码码率 (Kbps)。推荐取值可参考调参策略

@property (assign, nonatomic) NSInteger bitrate

Declared In

AgoraObjects.h

  contentHint

屏幕共享视频的内容类型。详见 AgoraVideoContentHint

@property (assign, nonatomic) AgoraVideoContentHint contentHint

Declared In

AgoraObjects.h