TranscodingUser

Transcoding configurations of each host.

truct TranscodingUser {
  uid_t uid;
  int x;
  int y;
  int width;
  int height;
  int zOrder;
  double alpha;
  int audioChannel;
  TranscodingUser()
      : uid(0),
        x(0),
        y(0),
        width(0),
        height(0),
        zOrder(0),
        alpha(1.0),
        audioChannel(0) {}
};

Attributes

uid

The user ID of the host.

x

The x coordinate (pixel) of the host's video on the output video frame (taking the upper left corner of the video frame as the origin). The value range is [0, width], where width is the width set in LiveTranscoding.

y
The y coordinate (pixel) of the host's video on the output video frame (taking the upper left corner of the video frame as the origin). The value range is [0, height], where height is the height set in LiveTranscoding.
width
The width (pixel) of the host's video.
height

The height (pixel) of the host's video.

zOrder
The layer index number of the host's video. The value range is [0, 100].
  • 0: (Default) The host's video is the bottom layer.
  • 100: The host's video is the top layer.
Attention:
  • If the value is less than 0 or greater than 100, ERR_INVALID_ARGUMENT error is returned.
  • Setting zOrder to 0 is supported.
alpha
The transparency of the host's video. The value range is [0.0,1.0].
  • 0.0: Completely transparent.
  • 1.0: (Default) Opaque.
audioChannel
The audio channel used by the host's audio in the output audio. The default value is 0, and the value range is [0, 5].
  • 0: (Recommended) The defaut setting, which supports dual channels at most and depends on the upstream of the host.
  • 1: The host's audio uses the FL audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
  • 2: The host's audio uses the FC audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
  • 3: The host's audio uses the FR audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
  • 4: The host's audio uses the BL audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
  • 5: The host's audio uses the BR audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
  • 0xFF or a value greater than 5: The host's audio is muted, and the Agora server removes the host's audio.
Attention: If the value is not 0, a special player is required.