Agora RTC Objective-C API Reference  Refactor
Data Fields
MediaSource Struct Reference

Data Fields

const char * url
 
const char * uri
 
int64_t startPos
 
bool autoPlay
 
bool enableCache
 
bool enableMultiAudioTrack
 
Optional< bool > isAgoraSource
 
Optional< bool > isLiveSource
 
IMediaPlayerCustomDataProviderprovider
 

Constructor & Destructor Documentation

◆ MediaSource()

MediaSource ( )
inline

Field Documentation

◆ url

const char* url

The URL of the media file that you want to play.

◆ uri

const char* uri

The URI of the media file

When caching is enabled, if the url cannot distinguish the cache file name, the uri must be able to ensure that the cache file name corresponding to the url is unique.

◆ startPos

int64_t startPos

Set the starting position for playback, in ms.

◆ autoPlay

bool autoPlay

Determines whether to autoplay after opening a media resource.

  • true: (Default) Autoplay after opening a media resource.
  • false: Do not autoplay after opening a media resource.

◆ enableCache

bool enableCache

Determines whether to enable cache streaming to local files. If enable cached, the media player will use the url or uri as the cache index.

Note
The local cache function only supports on-demand video/audio streams and does not support live streams. Caching video and audio files based on the HLS protocol (m3u8) to your local device is not supported.
  • true: Enable cache.
  • false: (Default) Disable cache.

◆ enableMultiAudioTrack

bool enableMultiAudioTrack

Determines whether to enable multi-track audio stream decoding. Then you can select multi audio track of the media file for playback or publish to channel

Note
If you use the selectMultiAudioTrack API, you must set enableMultiAudioTrack to true.
  • true: Enable MultiAudioTrack;.
  • false: (Default) Disable MultiAudioTrack;.

◆ isAgoraSource

Optional<bool> isAgoraSource

Determines whether the opened media resource is a stream through the Agora Broadcast Streaming Network(CDN).

  • true: It is a stream through the Agora Broadcast Streaming Network.
  • false: (Default) It is not a stream through the Agora Broadcast Streaming Network.

◆ isLiveSource

Optional<bool> isLiveSource

Determines whether the opened media resource is a live stream. If is a live stream, it can speed up the opening of media resources.

  • true: It is a live stream.
  • false: (Default) It is not is a live stream.

◆ provider

External custom data source object