Player Module API Manual#
Overview#
This document provides a detailed introduction to the K230_CanMV Player module API, designed to support playback of MP4 format files. This module can simultaneously play audio and video, with audio format supporting G.711A/U and video format supporting H.264/H.265 encoding.
API Introduction#
This module provides the Player class, which includes the following methods:
Constructor#
Description
Constructs a Player object based on the specified display_type. Users need to first create a Player object for subsequent operations.
Syntax
player = Player(display_type = Display.VIRT,display_to_ide = True)
Parameters
Parameter Name |
Description |
Input/Output |
Notes |
|---|---|---|---|
display_type |
Display device type |
Input |
|
display_to_ide |
Whether to also output to IDE virtual screen |
Input |
Return Value
Return Value |
Description |
|---|---|
Player Object |
The created Player instance |
Example
player = Player(Display.VIRT)
player = Player(Display.ST7701)
player = Player(Display.LT9611)
Player.load#
Description
Loads the specified file. The current version only supports MP4 format files.
Syntax
player = Player()
Player.load(filename = "test.mp4")
Parameters
Parameter Name |
Description |
Input/Output |
|---|---|---|
filename |
File name |
Input |
Return Value
Return Value |
Description |
|---|---|
None |
Notes
The current version only supports playback of MP4 format files.
Player.start#
Description
Starts playing audio and video content.
Syntax
player = Player()
player.start()
Parameters
None
Return Value
Return Value |
Description |
|---|---|
None |
Player.pause#
Description
Pauses the current playback.
Syntax
player = Player()
player.pause()
Parameters
None
Return Value
Return Value |
Description |
|---|---|
None |
Player.resume#
Description
Resumes playback.
Syntax
player = Player()
player.resume()
Parameters
None
Return Value
Return Value |
Description |
|---|---|
None |
Player.stop#
Description
Stops playback.
Syntax
player = Player()
player.stop()
Parameters
None
Return Value
Return Value |
Description |
|---|---|
None |
Player.destroy_mp4#
Description
Destroys the mp4 player
Syntax
Player.destroy_mp4()
Parameters
None
Return Value
Return Value |
Description |
|---|---|
None |
Player.set_event_callback#
Description
Sets the callback function for playback events.
Syntax
def player_event(event, data):
pass
player = Player()
player.set_event_callback(callback=player_event)
Parameters
Parameter Name |
Description |
Input/Output |
|---|---|---|
callback |
Callback function name |
Input |
Return Value
Return Value |
Description |
|---|---|
None |
Data Structure Description#
play_event_type#
Description
Defines the type of playback event.
Members
Member Name |
Description |
|---|---|
K_PLAYER_EVENT_EOF |
Playback ended |
K_PLAYER_EVENT_PROGRESS |
Playback progress |
Example Programs#
Example 1#
from media.player import *
import os
import time
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
# 使用 IDE 作为输出显示，支持任意分辨率；适用于 BPI 开发板
player = Player(Display.VIRT)
# 使用 ST7701 LCD 屏幕作为输出显示，最大分辨率为 800x480
# player = Player(Display.ST7701)
# 使用 HDMI 作为输出显示
# player = Player(Display.LT9611)
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_mp4_test("/sdcard/examples/test.mp4")