AgoraVideoOutputOrientationMode Constants Reference

Declared in AgoraEnumerates.h

AgoraVideoOutputOrientationMode

Video output orientation mode.

Note: When a custom video source is used, if you set AgoraVideoOutputOrientationMode as AgoraVideoOutputOrientationModeFixedLandscape(1) or AgoraVideoOutputOrientationModeFixedPortrait(2), when the rotated video image has a different orientation than the specified output orientation, the video encoder first crops it and then encodes it.

Definition

typedef NS_ENUM(NSInteger, AgoraVideoOutputOrientationMode ) {
   AgoraVideoOutputOrientationModeAdaptative = 0,
   AgoraVideoOutputOrientationModeFixedLandscape = 1,
   AgoraVideoOutputOrientationModeFixedPortrait = 2,
};

Constants

AgoraVideoOutputOrientationModeAdaptative

Adaptive mode (Default).

The video encoder adapts to the orientation mode of the video input device. When you use a custom video source, the output video from the encoder inherits the orientation of the original video.

  • If the width of the captured video from the SDK is greater than the height, the encoder sends the video in landscape mode. The encoder also sends the rotational information of the video, and the receiver uses the rotational information to rotate the received video.
  • If the original video is in portrait mode, the output video from the encoder is also in portrait mode. The encoder also sends the rotational information of the video to the receiver.

Declared In AgoraEnumerates.h.

AgoraVideoOutputOrientationModeFixedLandscape

Landscape mode.

The video encoder always sends the video in landscape mode. The video encoder rotates the original video before sending it and the rotational information is 0. This mode applies to scenarios involving CDN live streaming.

Declared In AgoraEnumerates.h.

AgoraVideoOutputOrientationModeFixedPortrait

Portrait mode.

The video encoder always sends the video in portrait mode. The video encoder rotates the original video before sending it and the rotational information is 0. This mode applies to scenarios involving CDN live streaming.

Declared In AgoraEnumerates.h.

Declared In

AgoraEnumerates.h