音视频播放开发指导

使用场景

音视频播放是将音视频文件或音视频流数据进行解码并通过输出设备进行播放的过程，同时对播放任务进行管理。

接口说明

音视频播放API接口功能如下，具体的API详见接口文档。

表 1 音视频播放API接口

类名

接口名

描述

Player

int32_t SetSource(const Source &source);

设置播放源

Player

int32_t Prepare();

准备播放

Player

int32_t Play();

开始播放

Player

bool IsPlaying()

判断是否播放中

Player

int32_t Pause();

暂停播放

Player

int32_t Stop();

停止播放

Player

int32_t Rewind(int_64 mSeconds, int32_t mode);

改变播放位置

Player

int32_t SetVolume(float leftVolume, float rightVolume);

设置音量，包括左声道和右声道。

Player

int32_t SetVideoSurface(Surface surface)

设置播放窗口

Player

int32_t EnableSingleLooping(bool loop)

设置循环播放

Player

bool IsSingleLooping();

判断是否循环播放

Player

int32_t GetCurrentTime(int64_t &time) const;

获取当前播放时长

Player

int32_t GetDuration(int64_t &duration) const;

获取总播放时长

Player

int32_t GetVideoWidth(int32_t &videoWidth);

获取视频源宽度

Player

int32_t GetVideoHeight(int32_t &videoHeight);

获取视频源高度

Player

int32_t Reset();

重置播放器

Player

int32_t Release();

释放播放器资源

Player

void SetPlayerCallback(const std::shared_ptr<PlayerCallback> &cb);

设置播放回调函数

Source

Source(const std::string& uri);

基于uri创建Source实例

Source

Source(const std::string &uri, const std::map<std::string, std::string> &header);

基于uri和uri header创建Source实例

Source

Source(const std::shared_ptr<StreamSource> &stream, const Format &formats);

基于流创建Source实例

Source

SourceType GetSourceType() const;

获取源类型

Source

const std::string &GetSourceUri() const;

获取音视频uri

Source

const std::map<std::string, std::string> &GetSourceHeader() const;

获取音视频uri header

Source

const std::shared_ptr<StreamSource> &GetSourceStream() const;

获取音视频流

Source

const Format &GetSourceStreamFormat() const;

获取音视频流格式

Format

bool PutIntValue(const std::string &key, int32_t value);

设置整数类型的元数据

Format

bool PutLongValue(const std::string &key, int64_t value);

设置长整数类型的元数据

Format

bool PutFloatValue(const std::string &key, float value);

设置单精度浮点类型的元数据

Format

bool PutDoubleValue(const std::string &key, double value);

设置双精度浮点类型的元数据

Format

bool PutStringValue(const std::string &key, const std::string &value);

设置字符串类型的元数据

Format

bool GetIntValue(const std::string &key, int32_t &value) const;

获取整数类型的元数据值

Format

bool GetLongValue(const std::string &key, int64_t &value) const;

获取长整数类型的元数据值

Format

bool GetFloatValue(const std::string &key, float &value) const;

获取单精度浮点类型的元数据值

Format

bool GetDoubleValue(const std::string &key, double &value) const;

获取双精度浮点类型的元数据值

Format

bool GetStringValue(const std::string &key, std::string &value) const;

获取字符串类型的元数据值

Format

const std::map<std::string, FormatData > &GetFormatMap() const;

获取元数据映射表

Format

bool CopyFrom(const Format &format);

用输入Format设置所有元数据

约束与限制

输入源为音视频流时，不支持播放进度控制和获取文件时长。

开发步骤

  1. 实现PlayerCallback回调，通过SetPlayerCallback函数进行绑定，用于事件处理。

    1. class TestPlayerCallback : public PlayerCallback{ 
    2.     void OnPlaybackComplete() override 
    3.     { 
    4.         //此处实现代码用于处理文件播放完成的事件 
    5.     } 
    6.     void OnError(int32_t errorType, int32_t errorCode) override 
    7.     { 
    8.         //此处实现代码处理错误事件 
    9.     } 
    10.     void OnInfo(int type, int extra) override 
    11.     { 
    12.         //此处实现代码处理普通事件 
    13.     } 
    14.     void OnRewindToComplete() override 
    15.     { 
    16.         //此处实现代码处理进度控制完成的事件 
    17.     } 
    18. };

  2. 创建Player实例，设置播放源并开始播放。

    1. Player *player = new Player(); 
    2. std::shared_ptr<PlayerCallback> callback = std::make_shared<TestPlayerCallback>(); 
    3. player->SetPlayerCallback(callback);//设置player回调 
    4. std::string uri(filePath);//此处filePath为本地文件路径 
    5. Source source(uri);//保存uri到source实例 
    6. player->SetSource(source);//将source设置到player 
    7. player->SetVideoSurface(surface);//设置播放窗口
    8. player->Prepare();//准备播放 
    9. player->Play();//开始播放

  3. 根据场景需要进行播放控制。

    1. player->SetVolume(lvolume, rvolume);//设置左右声道声音 
    2. player->EnableSingleLooping(true);//设置循环播放 
    3. player->Pause();//暂停 
    4. player->Play();//继续播放

  4. 播放任务结束后，进行资源释放。

    1. player->Stop(); //停止播放
    2. player->Release();//释放资源