无
int agora_iot_file_player_init(char *slave_server_url, const char *appid);
初始化文件播放器。
使用文件播放器前,你需要调用该方法初始化文件播放器。
参数 | 描述 |
---|---|
[in] slave_server_url |
SDK 使用的 AWS OpenAPI 服务的主机域名。你可以在声网灵隼控制台的应用配置>>开发者选项>>呼叫服务>>Slave Server URL 处获取。详见开通并配置声网灵隼服务。 |
[in] appid |
你的声网 App ID。可以从声网灵隼控制台的应用配置页面的开发者选项选项卡中获取。详见开通声网灵隼服务。 |
void agora_iot_file_player_deinit(void);
释放文件播放器的资源。
file_player_handle_t agora_iot_file_player_start(agora_iot_file_player_callback_t callback,
const char *channel_name);
创建本地回放频道。
如果多个用户需要同时查看不同的视频文件,你可以多次调用该方法创建多个本地回放频道。
如需销毁本地回放频道,调用 agora_iot_file_player_stop 方法。
参数 | 描述 |
---|---|
[in] callback |
注册本地回放事件。详见 agora_iot_file_player_callback_t。 |
[in] channel_name |
本地回放频道名称。 |
file_player_handle_t
:文件播放器句柄。
int agora_iot_file_player_stop(file_player_handle_t handle);
销毁本地回放频道。
成功销毁本地回放频道时,SDK 会触发 cb_stop_push_frame 回调。
参数 | 描述 |
---|---|
[in] handle |
文件播放器句柄。你可以通过 agora_iot_file_player_start 获取。 |
int agora_iot_file_player_push_video_frame(file_player_handle_t handle, ago_video_frame_t *frame);
发送视频帧到本地回放频道。
当 SDK 触发 cb_start_push_frame 回调时,你可以调用该方法把视频帧发送到本地回放频道。
参数 | 描述 |
---|---|
[in] handle |
文件播放器句柄。你可以通过 agora_iot_file_player_start 获取。 |
[in] frame |
待发送的视频帧信息,详见 ago_video_frame_t。 |
int agora_iot_file_player_push_audio_frame(file_player_handle_t handle, ago_audio_frame_t *frame);
发送音频帧到本地回放频道。
当 SDK 触发 cb_start_push_frame 回调时,你可以调用该方法把音频帧发送到本地回放频道。
参数 | 描述 |
---|---|
[in] handle |
文件播放器句柄。你可以通过 agora_iot_file_player_start 获取。 |
[in] frame |
待发送的音频帧信息,详见 ago_audio_frame_t。 |
typedef struct agora_iot_file_player_callback
{
void (*cb_start_push_frame)(const char *channel_name);
void (*cb_stop_push_frame)(const char *channel_name);
} agora_iot_file_player_callback_t;
本地回放相关回调。
调用 agora_iot_file_player_start 成功创建本地回放频道时,SDK 会触发该回调。此时,你可以调用 agora_iot_file_player_push_audio_frame 或 agora_iot_file_player_push_video_frame 方法发送音频或视频数据到本地回放频道。
参数
参数 | 描述 |
---|---|
channel_name |
本地回放的频道名称。通过该参数,你可以在业务逻辑中实现在客户端同时观看不同的视频回放文件。 |
调用 agora_iot_file_player_stop 成功销毁本地回放频道时,SDK 会触发该回调。此时,你需要停止调用 agora_iot_file_player_push_audio_frame 或 agora_iot_file_player_push_video_frame 方法。
参数
参数 | 描述 |
---|---|
channel_name |
本地回放的频道名称。通过该参数,你可以在业务逻辑中实现在客户端同时观看不同的视频回放文件。 |