Agora RTC Objective-C API Reference  Refactor
AgoraMediaPlayerTypes.h
Go to the documentation of this file.
1 //
2 // Agora Engine SDK
3 //
4 // Created by Sting Feng in 2020-05.
5 // Copyright (c) 2017 Agora.io. All rights reserved.
6 
7 #pragma once // NOLINT(build/header_guard)
8 
9 #include <cstring>
10 #include <stdint.h>
11 
12 #include "AgoraOptional.h"
13 
18 #define KEY_PLAYER_REAL_TIME_STREAM_ANALYZE_DURATION "analyze_duration"
19 
24 #define KEY_PLAYER_ENABLE_AUDIO "enable_audio"
25 
30 #define KEY_PLAYER_ENABLE_VIDEO "enable_video"
31 
36 #define KEY_PLAYER_ENABLE_SEARCH_METADATA "enable_search_metadata"
37 
42 #define KEY_PLAYER_SEI_FILTER_TYPE "set_sei_filter_type"
43 
44 namespace agora {
45 
46 namespace media {
47 
48 namespace base {
49 static const uint8_t kMaxCharBufferLength = 50;
103 };
163 };
164 
182 };
183 
244 };
245 
260 };
261 
269 
272 
275 
278 
281 
284 
287 
290 
293 
296 
299 
302 
304  int64_t duration;
305 
308  videoFrameRate(0),
309  videoBitRate(0),
310  videoWidth(0),
311  videoHeight(0),
312  videoRotation(0),
313  audioSampleRate(0),
314  audioChannels(0),
316  duration(0) {
317  memset(codecName, 0, sizeof(codecName));
318  memset(language, 0, sizeof(language));
319  }
320 };
321 
326 struct SrcInfo {
331 
335  const char* name;
336 
337 };
338 
350 };
351 
355  int64_t fileSize;
358  int64_t cacheSize;
361  int64_t downloadSize;
362 };
363 
371  int videoFps;
381 };
382 
390  const char* internalPlayerUuid;
393  const char* deviceId;
409 
411  : internalPlayerUuid(NULL),
412  deviceId(NULL),
413  videoHeight(0),
414  videoWidth(0),
415  audioSampleRate(0),
416  audioChannels(0),
417  audioBitsPerSample(0) {}
418 };
419 
424 public:
425 
432  virtual int onReadData(unsigned char *buffer, int bufferSize) = 0;
433 
446  virtual int64_t onSeek(int64_t offset, int whence) = 0;
447 
449 };
450 
451 struct MediaSource {
455  const char* url;
462  const char* uri;
466  int64_t startPos;
472  bool autoPlay;
512 
513  MediaSource() : url(NULL), uri(NULL), startPos(0), autoPlay(true), enableCache(false),
514  enableMultiAudioTrack(false), provider(NULL){
515  }
516 };
517 
518 } // namespace base
519 } // namespace media
520 } // namespace agora
agora::media::base::MediaSource::url
const char * url
Definition: AgoraMediaPlayerTypes.h:455
agora::media::base::PLAYER_REASON_INTERNAL
@ PLAYER_REASON_INTERNAL
Definition: AgoraMediaPlayerTypes.h:117
agora::media::base::PlayerStreamInfo::videoRotation
int videoRotation
Definition: AgoraMediaPlayerTypes.h:292
agora::media::base::PLAYER_REASON_OBJ_NOT_INITIALIZED
@ PLAYER_REASON_OBJ_NOT_INITIALIZED
Definition: AgoraMediaPlayerTypes.h:129
agora::media::base::PLAYER_REASON_NOT_SUPPORTED
@ PLAYER_REASON_NOT_SUPPORTED
Definition: AgoraMediaPlayerTypes.h:153
agora::media::base::PlayerUpdatedInfo::audioSampleRate
int audioSampleRate
Definition: AgoraMediaPlayerTypes.h:402
agora::media::base::MediaSource::isLiveSource
Optional< bool > isLiveSource
Definition: AgoraMediaPlayerTypes.h:507
agora::media::base::PlayerStreamInfo::PlayerStreamInfo
PlayerStreamInfo()
Definition: AgoraMediaPlayerTypes.h:306
agora::media::base::PLAYER_STATE_FAILED
@ PLAYER_STATE_FAILED
Definition: AgoraMediaPlayerTypes.h:102
agora::media::base::PLAYER_STATE_STOPPED
@ PLAYER_STATE_STOPPED
Definition: AgoraMediaPlayerTypes.h:78
agora::media::base::MEDIA_STREAM_TYPE
MEDIA_STREAM_TYPE
The type of the media stream.
Definition: AgoraMediaPlayerTypes.h:169
agora::media::base::PLAYER_STATE_OPEN_COMPLETED
@ PLAYER_STATE_OPEN_COMPLETED
Definition: AgoraMediaPlayerTypes.h:63
agora::media::base::MediaSource::autoPlay
bool autoPlay
Definition: AgoraMediaPlayerTypes.h:472
agora::media::base::PLAYER_STATE_PAUSING_INTERNAL
@ PLAYER_STATE_PAUSING_INTERNAL
Definition: AgoraMediaPlayerTypes.h:81
agora::media::base::PLAYER_REASON_UNKNOWN
@ PLAYER_REASON_UNKNOWN
Definition: AgoraMediaPlayerTypes.h:162
agora::media::base::PlayerUpdatedInfo::videoHeight
int videoHeight
Definition: AgoraMediaPlayerTypes.h:396
agora::media::base::CacheStatistics
Definition: AgoraMediaPlayerTypes.h:352
agora::media::base::PLAYER_EVENT_BUFFER_LOW
@ PLAYER_EVENT_BUFFER_LOW
Definition: AgoraMediaPlayerTypes.h:203
agora::media::base::MediaSource::uri
const char * uri
Definition: AgoraMediaPlayerTypes.h:462
agora::media::base::PlayerUpdatedInfo
The updated information of media player.
Definition: AgoraMediaPlayerTypes.h:387
agora::media::base::PLAYER_REASON_UNKNOWN_STREAM_TYPE
@ PLAYER_REASON_UNKNOWN_STREAM_TYPE
Definition: AgoraMediaPlayerTypes.h:126
agora::media::base::PLAYER_REASON_INVALID_CONNECTION_STATE
@ PLAYER_REASON_INVALID_CONNECTION_STATE
Definition: AgoraMediaPlayerTypes.h:144
agora::media::base::MEDIA_PLAYER_EVENT
MEDIA_PLAYER_EVENT
The playback event.
Definition: AgoraMediaPlayerTypes.h:188
agora::media::base::PLAYER_EVENT_SEEK_ERROR
@ PLAYER_EVENT_SEEK_ERROR
Definition: AgoraMediaPlayerTypes.h:197
agora::media::base::PLAYER_REASON_IP_EXPIRED
@ PLAYER_REASON_IP_EXPIRED
Definition: AgoraMediaPlayerTypes.h:159
agora::media::base::PLAYER_REASON_VIDEO_RENDER_FAILED
@ PLAYER_REASON_VIDEO_RENDER_FAILED
Definition: AgoraMediaPlayerTypes.h:135
agora::media::base::STREAM_TYPE_UNKNOWN
@ STREAM_TYPE_UNKNOWN
Definition: AgoraMediaPlayerTypes.h:172
agora::media::base::PLAYER_REASON_NO_RESOURCE
@ PLAYER_REASON_NO_RESOURCE
Definition: AgoraMediaPlayerTypes.h:120
agora::media::base::IMediaPlayerCustomDataProvider::~IMediaPlayerCustomDataProvider
virtual ~IMediaPlayerCustomDataProvider()
Definition: AgoraMediaPlayerTypes.h:448
agora::media::base::PLAYER_REASON_TOKEN_EXPIRED
@ PLAYER_REASON_TOKEN_EXPIRED
Definition: AgoraMediaPlayerTypes.h:156
agora::media::base::PLAYER_EVENT_HTTP_REDIRECT
@ PLAYER_EVENT_HTTP_REDIRECT
Definition: AgoraMediaPlayerTypes.h:243
agora::media::base::CacheStatistics::downloadSize
int64_t downloadSize
Definition: AgoraMediaPlayerTypes.h:361
agora::media::base::PLAYER_REASON_INVALID_ARGUMENTS
@ PLAYER_REASON_INVALID_ARGUMENTS
Definition: AgoraMediaPlayerTypes.h:114
agora::media::base::MEDIA_PLAYER_STATE
MEDIA_PLAYER_STATE
The playback state.
Definition: AgoraMediaPlayerTypes.h:54
agora::media::base::PLAYER_STATE_GETTING_INTERNAL
@ PLAYER_STATE_GETTING_INTERNAL
Definition: AgoraMediaPlayerTypes.h:90
agora::media::base::PLAYER_PRELOAD_EVENT_COMPLETE
@ PLAYER_PRELOAD_EVENT_COMPLETE
Definition: AgoraMediaPlayerTypes.h:256
agora
Definition: AgoraAtomicOps.h:21
agora::media::base::PLAYER_REASON_INTERRUPTED
@ PLAYER_REASON_INTERRUPTED
Definition: AgoraMediaPlayerTypes.h:150
agora::media::base::PlayerUpdatedInfo::audioChannels
int audioChannels
Definition: AgoraMediaPlayerTypes.h:405
agora::media::base::PlayerPlaybackStats::audioBitrateInKbps
int audioBitrateInKbps
Definition: AgoraMediaPlayerTypes.h:377
agora::media::base::PLAYER_METADATA_TYPE_SEI
@ PLAYER_METADATA_TYPE_SEI
Definition: AgoraMediaPlayerTypes.h:349
agora::media::base::IMediaPlayerCustomDataProvider
Definition: AgoraMediaPlayerTypes.h:423
agora::media::base::PLAYER_EVENT_SWITCH_BEGIN
@ PLAYER_EVENT_SWITCH_BEGIN
Definition: AgoraMediaPlayerTypes.h:215
agora::media::base::PLAYER_STATE_PLAYBACK_COMPLETED
@ PLAYER_STATE_PLAYBACK_COMPLETED
Definition: AgoraMediaPlayerTypes.h:72
agora::media::base::PlayerUpdatedInfo::deviceId
const char * deviceId
Definition: AgoraMediaPlayerTypes.h:393
agora::media::base::SrcInfo::bitrateInKbps
int bitrateInKbps
Definition: AgoraMediaPlayerTypes.h:330
agora::media::base::CacheStatistics::fileSize
int64_t fileSize
Definition: AgoraMediaPlayerTypes.h:355
agora::media::base::PLAYER_STATE_PAUSED
@ PLAYER_STATE_PAUSED
Definition: AgoraMediaPlayerTypes.h:69
agora::media::base::PLAYER_EVENT_SWITCH_ERROR
@ PLAYER_EVENT_SWITCH_ERROR
Definition: AgoraMediaPlayerTypes.h:221
agora::media::base::PLAYER_REASON_URL_NOT_FOUND
@ PLAYER_REASON_URL_NOT_FOUND
Definition: AgoraMediaPlayerTypes.h:141
agora::media::base::PLAYER_PRELOAD_EVENT_ERROR
@ PLAYER_PRELOAD_EVENT_ERROR
Definition: AgoraMediaPlayerTypes.h:259
agora::media::base::PLAYER_EVENT_AUDIO_TRACK_CHANGED
@ PLAYER_EVENT_AUDIO_TRACK_CHANGED
Definition: AgoraMediaPlayerTypes.h:200
agora::media::base::PlayerStreamInfo
The information of the media stream object.
Definition: AgoraMediaPlayerTypes.h:266
agora::media::base::PLAYER_STATE_OPENING
@ PLAYER_STATE_OPENING
Definition: AgoraMediaPlayerTypes.h:60
agora::media::base::PLAYER_PRELOAD_EVENT_BEGIN
@ PLAYER_PRELOAD_EVENT_BEGIN
Definition: AgoraMediaPlayerTypes.h:253
agora::media::base::PLAYER_STATE_PLAYING
@ PLAYER_STATE_PLAYING
Definition: AgoraMediaPlayerTypes.h:66
agora::media::base::PLAYER_EVENT_REACH_CACHE_FILE_MAX_SIZE
@ PLAYER_EVENT_REACH_CACHE_FILE_MAX_SIZE
Definition: AgoraMediaPlayerTypes.h:230
agora::media::base::PLAYER_EVENT_TRY_OPEN_START
@ PLAYER_EVENT_TRY_OPEN_START
Definition: AgoraMediaPlayerTypes.h:233
agora::media::base::MediaSource::provider
IMediaPlayerCustomDataProvider * provider
Definition: AgoraMediaPlayerTypes.h:511
agora::media::base::MediaSource::enableMultiAudioTrack
bool enableMultiAudioTrack
Definition: AgoraMediaPlayerTypes.h:495
agora::media::base::PLAYER_REASON_SRC_BUFFER_UNDERFLOW
@ PLAYER_REASON_SRC_BUFFER_UNDERFLOW
Definition: AgoraMediaPlayerTypes.h:147
agora::media::base::PlayerPlaybackStats::videoFps
int videoFps
Definition: AgoraMediaPlayerTypes.h:371
agora::media::base::PLAYER_REASON_CODEC_NOT_SUPPORTED
@ PLAYER_REASON_CODEC_NOT_SUPPORTED
Definition: AgoraMediaPlayerTypes.h:132
agora::media::base::PLAYER_STATE_IDLE
@ PLAYER_STATE_IDLE
Definition: AgoraMediaPlayerTypes.h:57
agora::media::base::MediaSource
Definition: AgoraMediaPlayerTypes.h:451
agora::media::base::PlayerPlaybackStats
The real time statistics of the media stream being played.
Definition: AgoraMediaPlayerTypes.h:368
agora::media::base::PLAYER_STATE_SET_TRACK_INTERNAL
@ PLAYER_STATE_SET_TRACK_INTERNAL
Definition: AgoraMediaPlayerTypes.h:99
agora::media::base::PlayerStreamInfo::videoWidth
int videoWidth
Definition: AgoraMediaPlayerTypes.h:286
agora::media::base::PLAYER_EVENT_FREEZE_STOP
@ PLAYER_EVENT_FREEZE_STOP
Definition: AgoraMediaPlayerTypes.h:212
agora::media::base::PLAYER_STATE_STOPPING_INTERNAL
@ PLAYER_STATE_STOPPING_INTERNAL
Definition: AgoraMediaPlayerTypes.h:84
agora::media::base::PlayerStreamInfo::duration
int64_t duration
Definition: AgoraMediaPlayerTypes.h:304
agora::media::base::CacheStatistics::cacheSize
int64_t cacheSize
Definition: AgoraMediaPlayerTypes.h:358
agora::media::base::STREAM_TYPE_SUBTITLE
@ STREAM_TYPE_SUBTITLE
Definition: AgoraMediaPlayerTypes.h:181
agora::media::base::PLAYER_REASON_INVALID_STATE
@ PLAYER_REASON_INVALID_STATE
Definition: AgoraMediaPlayerTypes.h:138
agora::media::base::MEDIA_PLAYER_METADATA_TYPE
MEDIA_PLAYER_METADATA_TYPE
The type of the media metadata.
Definition: AgoraMediaPlayerTypes.h:343
AgoraOptional.h
agora::media::base::PLAYER_EVENT_TRY_OPEN_SUCCEED
@ PLAYER_EVENT_TRY_OPEN_SUCCEED
Definition: AgoraMediaPlayerTypes.h:236
agora::media::base::PLAYER_EVENT_SWITCH_COMPLETE
@ PLAYER_EVENT_SWITCH_COMPLETE
Definition: AgoraMediaPlayerTypes.h:218
agora::media::base::PLAYER_REASON_NONE
@ PLAYER_REASON_NONE
Definition: AgoraMediaPlayerTypes.h:111
agora::media::base::MediaSource::enableCache
bool enableCache
Definition: AgoraMediaPlayerTypes.h:484
agora::media::base::IMediaPlayerCustomDataProvider::onReadData
virtual int onReadData(unsigned char *buffer, int bufferSize)=0
The player requests to read the data callback, you need to fill the specified length of data into the...
agora::media::base::PlayerPlaybackStats::totalBitrateInKbps
int totalBitrateInKbps
Definition: AgoraMediaPlayerTypes.h:380
agora::media::base::PLAYER_STATE_DO_NOTHING_INTERNAL
@ PLAYER_STATE_DO_NOTHING_INTERNAL
Definition: AgoraMediaPlayerTypes.h:96
agora::media::base::PlayerStreamInfo::codecName
char codecName[kMaxCharBufferLength]
Definition: AgoraMediaPlayerTypes.h:274
agora::media::base::MediaSource::isAgoraSource
Optional< bool > isAgoraSource
Definition: AgoraMediaPlayerTypes.h:501
agora::media::base::IMediaPlayerCustomDataProvider::onSeek
virtual int64_t onSeek(int64_t offset, int whence)=0
The Player seek event callback, you need to operate the corresponding stream seek operation,...
agora::media::base::PlayerUpdatedInfo::internalPlayerUuid
const char * internalPlayerUuid
Definition: AgoraMediaPlayerTypes.h:390
agora::media::base::PLAYER_EVENT_SEEK_COMPLETE
@ PLAYER_EVENT_SEEK_COMPLETE
Definition: AgoraMediaPlayerTypes.h:194
agora::media::base::SrcInfo::name
const char * name
Definition: AgoraMediaPlayerTypes.h:335
agora::media::base::PLAYER_STATE_PLAYBACK_ALL_LOOPS_COMPLETED
@ PLAYER_STATE_PLAYBACK_ALL_LOOPS_COMPLETED
Definition: AgoraMediaPlayerTypes.h:75
agora::media::base::SrcInfo
The information of the media stream object.
Definition: AgoraMediaPlayerTypes.h:326
agora::media::base::PLAYER_EVENT_TRY_OPEN_FAILED
@ PLAYER_EVENT_TRY_OPEN_FAILED
Definition: AgoraMediaPlayerTypes.h:239
agora::media::base::PLAYER_METADATA_TYPE_UNKNOWN
@ PLAYER_METADATA_TYPE_UNKNOWN
Definition: AgoraMediaPlayerTypes.h:346
agora::media::base::PLAYER_PRELOAD_EVENT
PLAYER_PRELOAD_EVENT
The play preload another source event.
Definition: AgoraMediaPlayerTypes.h:250
agora::media::base::PlayerStreamInfo::videoHeight
int videoHeight
Definition: AgoraMediaPlayerTypes.h:289
agora::media::base::PLAYER_STATE_SEEKING_INTERNAL
@ PLAYER_STATE_SEEKING_INTERNAL
Definition: AgoraMediaPlayerTypes.h:87
agora::media::base::PlayerStreamInfo::audioSampleRate
int audioSampleRate
Definition: AgoraMediaPlayerTypes.h:295
agora::media::base::PlayerStreamInfo::videoFrameRate
int videoFrameRate
Definition: AgoraMediaPlayerTypes.h:280
agora::media::base::PLAYER_EVENT_REACH_CACHE_FILE_MAX_COUNT
@ PLAYER_EVENT_REACH_CACHE_FILE_MAX_COUNT
Definition: AgoraMediaPlayerTypes.h:227
agora::media::base::MEDIA_PLAYER_REASON
MEDIA_PLAYER_REASON
Player error code.
Definition: AgoraMediaPlayerTypes.h:108
agora::media::base::PLAYER_EVENT_SEEK_BEGIN
@ PLAYER_EVENT_SEEK_BEGIN
Definition: AgoraMediaPlayerTypes.h:191
agora::media::base::PlayerUpdatedInfo::PlayerUpdatedInfo
PlayerUpdatedInfo()
Definition: AgoraMediaPlayerTypes.h:410
agora::media::base::PlayerUpdatedInfo::audioBitsPerSample
int audioBitsPerSample
Definition: AgoraMediaPlayerTypes.h:408
agora::media::base::PLAYER_EVENT_FREEZE_START
@ PLAYER_EVENT_FREEZE_START
Definition: AgoraMediaPlayerTypes.h:209
agora::media::base::PlayerStreamInfo::videoBitRate
int videoBitRate
Definition: AgoraMediaPlayerTypes.h:283
agora::media::base::PLAYER_STATE_NONE_INTERNAL
@ PLAYER_STATE_NONE_INTERNAL
Definition: AgoraMediaPlayerTypes.h:93
agora::media::base::PlayerStreamInfo::language
char language[kMaxCharBufferLength]
Definition: AgoraMediaPlayerTypes.h:277
agora::media::base::PlayerPlaybackStats::videoBitrateInKbps
int videoBitrateInKbps
Definition: AgoraMediaPlayerTypes.h:374
agora::media::base::PlayerStreamInfo::streamType
MEDIA_STREAM_TYPE streamType
Definition: AgoraMediaPlayerTypes.h:271
agora::media::base::kMaxCharBufferLength
static const uint8_t kMaxCharBufferLength
Definition: AgoraMediaPlayerTypes.h:49
agora::media::base::PlayerUpdatedInfo::videoWidth
int videoWidth
Definition: AgoraMediaPlayerTypes.h:399
agora::media::base::PLAYER_EVENT_BUFFER_RECOVER
@ PLAYER_EVENT_BUFFER_RECOVER
Definition: AgoraMediaPlayerTypes.h:206
agora::media::base::STREAM_TYPE_AUDIO
@ STREAM_TYPE_AUDIO
Definition: AgoraMediaPlayerTypes.h:178
agora::media::base::PlayerStreamInfo::audioBitsPerSample
int audioBitsPerSample
Definition: AgoraMediaPlayerTypes.h:301
agora::media::base::PLAYER_EVENT_FIRST_DISPLAYED
@ PLAYER_EVENT_FIRST_DISPLAYED
Definition: AgoraMediaPlayerTypes.h:224
agora::media::base::PLAYER_REASON_INVALID_MEDIA_SOURCE
@ PLAYER_REASON_INVALID_MEDIA_SOURCE
Definition: AgoraMediaPlayerTypes.h:123
agora::Optional< bool >
agora::media::base::PlayerStreamInfo::audioChannels
int audioChannels
Definition: AgoraMediaPlayerTypes.h:298
agora::media::base::MediaSource::MediaSource
MediaSource()
Definition: AgoraMediaPlayerTypes.h:513
agora::media::base::PlayerStreamInfo::streamIndex
int streamIndex
Definition: AgoraMediaPlayerTypes.h:268
agora::media::base::STREAM_TYPE_VIDEO
@ STREAM_TYPE_VIDEO
Definition: AgoraMediaPlayerTypes.h:175
agora::media::base::MediaSource::startPos
int64_t startPos
Definition: AgoraMediaPlayerTypes.h:466