# Player Example

## Overview

This sample demonstrates the K230 player module, which is a higher-level wrapper for synchronized audio and video playback.

## Functional Description

### Player Functions

- video playback
- audio playback
- audio/video synchronization
- connector-based output selection

### Supported Formats

Supported formats in this sample include:

- container format: MP4
- codecs: H.264, H.265, G711, OPUS, and related supported paths

### Main APIs

- `kd_player_init()`
- `kd_player_deinit()`
- `kd_player_start()`
- `kd_player_stop()`
- `kd_player_pause()`
- `kd_player_resume()`
- `kd_player_register_event_cb()`

### Player Events

| Event | Description |
| --- | --- |
| `K_PLAYER_EVENT_EOF` | end of playback |
| `K_PLAYER_EVENT_ERROR` | playback error |

## Source Location

```bash
src/rtsmart/examples/mpp/sample_player
```

## Usage

### Build Method

Enable the player sample in `make menuconfig`, then rebuild the firmware.

### Run Example

```bash
./sample_player.elf <file_path> <connect_type>
```

### Parameter Description

- `file_path`: media file path
- `connect_type`: connector type such as `20` for LCD or `101` for HDMI

### Expected Result

The player initializes the media subsystem, opens the file, parses audio and video streams, starts playback, reports progress and events, and exits after playback finishes.

Representative output:

```text
./sample_player.elf ./test_800x480.mp4 20
file pathname:./test_800x480.mp4
connector type:20
video track info:type:96,track_id:1,width:800,height:480
input_pool_id 0
output_pool_id 1
VDEC: pool_id 1, frame_buf_pool_id 1
sample_vo_init>vo init width 800 height 480
sample_vo_init: layer_id 1, width 800, height 480, pixel_format 31, func 2,buf_nr:3
VDEC: first pts 5940, frame_interval 0
VDEC: first pts 5940, frame_interval 12060
kd_mp4_get_frame: demuxer has finished.
demuxer finished.
5941 pictures decoded. Average FrameRate = 99 Fps
vpu report fps 99
disp_play>ch 0, receive eos
vpu_exit>q_wm 16
```

```{admonition} Tip
The player module is built on K230 MPP and codec components, and provides a simpler interface than direct MPI usage. For API details, refer to [Multimedia Middleware API](../../api_reference/middleware/multimedia_middleware.md).
```