Player Module API Manual#
Overview#
This document provides a detailed introduction to the K230_CanMV Player module API, which is designed to support the playback of MP4 format files. This module can simultaneously play audio and video, with audio formats supporting G.711A/U and video formats supporting H.264/H.265 encoding.
API Introduction#
The 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 create a Player object first to perform subsequent operations.
Syntax
player = Player(display_type = Display.VIRT,display_to_ide = True)
Parameters
Parameter Name |
Description |
Input/Output |
Notes |
|---|---|---|---|
display_type |
Type of display device |
Input |
|
display_to_ide |
Whether to output to IDE virtual screen simultaneously |
Input |
Return Value
Return Value |
Description |
|---|---|
Player object |
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("test.mp4")
Parameters
Parameter Name |
Description |
Input/Output |
|---|---|---|
filename |
File name |
Input |
Return Value
Return Value |
Description |
|---|---|
None |
Note
The current version only supports playing 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
Destroy 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 types of playback events.
Members
Member Name |
Description |
|---|---|
K_PLAYER_EVENT_EOF |
Playback End |
K_PLAYER_EVENT_PROGRESS |
Playback Progress |
Example Program#
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
# Use IDE as output display, supports any resolution; suitable for BPI development board
player = Player(Display.VIRT)
# Use ST7701 LCD screen as output display, maximum resolution is 800x480
# player = Player(Display.ST7701)
# Use HDMI as output display
# 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("Playback finished")
play_mp4_test("/sdcard/examples/test.mp4")