Voice SDK for Unity
- API Overview
  Agora provides ensured quality of experience (QoE) for worldwide Internet-based voice and video communications through SD-RTN™.
- IRtcEngine
  The basic interface of the Agora SDK that implements the core functions of real-time communication.
- IRtcEngineEx
  This interface class contains multi-channel methods.
- IRtcEngineEventHandler
  The SDK uses the IRtcEngineEventHandler interface to send event notifications to your app. Your app can get those notifications through methods that inherit this interface.
- IMediaPlayer
  This class provides media player functions and supports multiple instances.
- IMediaPlayerAudioFrameObserver
  The audio frame observer for the media player.
- IMediaPlayerCacheManager
  This class provides methods to manage cached media files.
- IMediaPlayerCustomDataProvider
  The callback for custom media resource files.
- IMediaPlayerSourceObserver
  Provides callbacks for media players.
- IAudioEncodedFrameObserver
  The encoded audio observer.
- IAudioDeviceManager
  Audio device management methods.
- IAudioPcmFrameSink
  This class is used to get raw PCM audio.
- IAudioFrameObserver
  The audio frame observer.
- IAudioSpectrumObserver
  The audio spectrum observer.
- IMetadataObserver
  The metadata observer.
- IVideoDeviceManager
  Video device management methods.
- IVideoEncodedFrameObserver
  Receives encoded video images.
- IVideoFrameObserver
  The IVideoFrameObserver class.
- IFaceInfoObserver
  Facial information observer.
- ILocalSpatialAudioEngine
  This class calculates user positions through the SDK to implement the spatial audio effect.
- VideoSurface
  This class contains Unity native methods related to video rendering.
- VideoSurfaceYUV
  Porivdes APIs for rendering videos. This class inherits all APIs from the VideoSurface class, but enables you to render video images with high resolutions (such as 4K) faster and at higher frame rates. As of v4.2.0, Agora Unity SDK does not support rendering different video sources with both VideoSurface and VideoSurfaceYUV at the same time. Specifically, after successfully creating IRtcEngine, if the first view is rendered with VideoSurfaceYUV, then only VideoSurfaceYUV can be used for rendering throughout the entire lifecycle of IRtcEngine.
- Class and Enum
  This page lists all the definitions of Class and the enums for Unity.

IMetadataObserver

The metadata observer.

You can call RegisterMediaMetadataObserver to register or unregister the IMetadataObserver object.

OnMetadataReceived

Occurs when the local user receives the metadata.

public virtual void OnMetadataReceived(Metadata metadata)
        {

        }

Parameters

metadata: The metadata received. See Metadata.

OnReadyToSendMetadata

Occurs when the SDK is ready to send metadata.

public virtual bool OnReadyToSendMetadata(ref Metadata metadata, VIDEO_SOURCE_TYPE source_type)
        {
            return false;
        }

This callback is triggered when the SDK is ready to send metadata.

Parameters

source_type: Video data type. See VIDEO_SOURCE_TYPE.
metadata: The metadata that the user wants to send. See Metadata.

Returns

true: Send the video frame.
false: Do not send the video frame.

SendMetadata

Sends media metadata.

public abstract int SendMetadata(Metadata metadata, VIDEO_SOURCE_TYPE source_type);

Details

If the metadata is sent successfully, the SDK triggers the OnMetadataReceived callback on the receiver.

Parameters

metadata: Media metadata. See Metadata.
source_type: The type of the video source. See VIDEO_SOURCE_TYPE.

Returns

0: Success.
< 0: Failure.

SetMaxMetadataSize

Sets the maximum size of the media metadata.

public abstract int SetMaxMetadataSize(int size);

Details

After calling RegisterMediaMetadataObserver, you can call this method to set the maximum size of the media metadata.

Parameters

size: The maximum size of media metadata.

Returns

0: Success.
< 0: Failure.