3.8 播放器 模块API手册#

前言#

概述#

本文档主要介绍K230_CanMV 播放器模块API的使用。

读者对象#

本文档(本指南)主要适用于以下人员:

  • 技术支持工程师

  • 软件开发工程师

修订记录#

文档版本号

修改说明

修改者

日期

V1.0

初版

孙小朋

2023-10-27

1. 概述#

此文档介绍K230_CanMV 播放器模块API,可播放mp4格式文件。支持音视频同时播放,音频支持g711a/u,视频支持H264/H265。

2. API描述#

提供Player类,该类提供如下方法:

2.1 Player.load#

【描述】

加载文件,当前版本只支持mp4格式文件

【语法】

player=Player()
player.load("test.mp4")

【参数】

参数名称

描述

输入/输出

filename

文件名称

输入

【返回值】

返回值

描述

0

成功

非 0

失败

【注意】

当前版本只支持播放mp4格式文件

【举例】

【相关主题】

2.2 Player.start#

【描述】

开始播放

【语法】

player=Player()
player.start()

【参数】

【返回值】

返回值

描述

0

成功

非0

失败

【注意】

【举例】

2.3 Player.pause#

【描述】

暂停播放

【语法】

player=Player()
player.pause()

【参数】

【返回值】

返回值

描述

0

成功

非0

失败

【注意】

【举例】

2.4 Player.resume#

【描述】

继续播放

【语法】

player=Player()
player.resume()

【参数】

【返回值】

返回值

描述

0

成功

非0

失败

【注意】

【举例】

2.5 Player.stop#

【描述】

停止播放

【语法】

player=Player()
player.stop()

【参数】

【返回值】

返回值

描述

0

成功

非0

失败

【注意】

【举例】

2.6 Player.set_event_callback#

【描述】

设置播放事件回调函数

【参数】

参数名称

描述

输入/输出

callback

回调函数名

输入

【语法】


def player_event(event,data):
    pass

player=Player()
player.set_event_callback(callback=player_event)

【参数】

【返回值】

返回值

描述

0

成功

非0

失败

【注意】

【举例】

3. 数据结构描述#

3.1 playe_event_type#

【描述】

编码格式类型

【成员】

成员名称

描述

K_PLAYER_EVENT_EOF

播放结束

K_PLAYER_EVENT_PROGRESS

播放进度

4. 示例程序#

4.1 例程1#

from media.player import *
import os

start_play = False
def player_event(event,data):
    global start_play
    if(event == K_PLAYER_EVENT_EOF):
        start_play = False

def play_mp4_test(filename):
    global start_play
    player=Player()
    player.load(filename)
    player.set_event_callback(player_event)
    player.start()
    start_play = True

    while(start_play):
        time.sleep(0.1)

    player.stop()
    print("play over")

play_mp4_test("/sdcard/app/tests/test.mp4")