tz/linuxOS_AP06
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
7bf276014d
linuxOS_AP06/app/rkadk/include/rkadk_player.h
hyx f2ecbedc91 v1.1.1
2025-06-03 12:28:32 +08:00

453 lines
16 KiB
C
Raw Blame History

/*
* Copyright (c) 2021 Rockchip, Inc. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef __RKADK_PLAYER_H__
#define __RKADK_PLAYER_H__
#ifdef __cplusplus
extern "C" {
#endif
#include "rkadk_common.h"
#include <stdbool.h>
#define USE_AO_MIXER 0
#define VIDEO_ID 1
#define AUDIO_ID 2
#define MIX_VIDEO_FLAG 1
#define VIDEO_FLAG 2
#define AUDIO_FLAG 3
#define MAX_VDEC_PIXEL 9437184
#define VDEC_ARRAY_ELEMS(a) (sizeof(a) / sizeof((a)[0]))
#define MAX_FRAME_QUEUE 3
#define MAX_TIME_OUT_MS 20
#define RK356X_VOP_LAYER_CLUSTER_0 0
#define RK356X_VOP_LAYER_CLUSTER_1 2
#define RK356X_VOP_LAYER_ESMART_0 4
#define RK356X_VOP_LAYER_ESMART_1 5
#define RK356X_VOP_LAYER_SMART_0 6
#define RK356X_VOP_LAYER_SMART_1 7
#define RK356X_VO_DEV_HD0 0
#define RK356X_VO_DEV_HD1 1
#define MAX_VO_FORMAT_RGB_NUM 17
#define WBC_FORMAT_BGRA8888 0
#define WBC_FORMAT_RGBA8888 1
#define WBC_FORMAT_RGB888 2
#define WBC_FORMAT_BGR888 3
#define WBC_FORMAT_YUV420SP 4
#define WBC_FORMAT_YUV420SP_VU 5
#define VO_CHANNEL_PLAY_NORMAL 0
#define VO_CHANNEL_PLAY_PAUSE 1
#define VO_CHANNEL_PLAY_STEP 2
#define VO_CHANNEL_PLAY_SPEED 3
#define WBC_SOURCE_DEV 0
#define WBC_SOURCE_VIDEO 1
#define WBC_SOURCE_GRAPHIC 2
#define MAX_STEP_FRAME_NUM 50
#define ARRAY_LENGTH(a) (sizeof (a) / sizeof (a)[0])
/** Error information of the player*/
typedef enum {
RKADK_PLAYER_ERROR_VID_PLAY_FAIL = 0x0, /**< The video fails to be played. */
RKADK_PLAYER_ERROR_AUD_PLAY_FAIL, /**< The audio fails to be played. */
RKADK_PLAYER_ERROR_DEMUX_FAIL, /**< The file fails to be played. */
RKADK_PLAYER_ERROR_TIMEOUT, /**< Operation timeout. For example, reading data
timeout. */
RKADK_PLAYER_ERROR_NOT_SUPPORT, /**< The file format is not supportted. */
RKADK_PLAYER_ERROR_UNKNOW, /**< Unknown error. */
RKADK_PLAYER_ERROR_ILLEGAL_STATEACTION, /**< illegal action at cur state. */
RKADK_PLAYER_ERROR_BUTT,
} RKADK_PLAYER_ERROR_E;
/** Player status*/
typedef enum {
RKADK_PLAYER_STATE_IDLE = 0, /**< The player state before init . */
RKADK_PLAYER_STATE_INIT, /**< The player is in the initial state. It changes
to the initial state after being SetDataSource. */
RKADK_PLAYER_STATE_PREPARED, /**< The player is in the prepared state. */
RKADK_PLAYER_STATE_PLAY, /**< The player is in the playing state. */
RKADK_PLAYER_STATE_EOF, /**< The player is in the playered end state. */
RKADK_PLAYER_STATE_PAUSE, /**< The player is in the pause state. */
RKADK_PLAYER_STATE_STOP, /**< The player is in the stop state. */
RKADK_PLAYER_STATE_ERR, /**< The player is in the err state(reserved). */
RKADK_PLAYER_STATE_BUTT
} RKADK_PLAYER_STATE_E;
typedef enum {
RKADK_PLAYER_EVENT_STATE_CHANGED = 0x0, /**< the player status changed */
RKADK_PLAYER_EVENT_PREPARED,
RKADK_PLAYER_EVENT_PLAY,
RKADK_PLAYER_EVENT_PAUSED,
RKADK_PLAYER_EVENT_STOPPED,
RKADK_PLAYER_EVENT_EOF, /**< the player is playing the end */
RKADK_PLAYER_EVENT_SOF, /**< the player backward tplay to the start of file*/
RKADK_PLAYER_EVENT_SEEK_END, /**< seek time jump, the additional value is the
seek value */
RKADK_PLAYER_EVENT_ERROR, /**< play error */
RKADK_PLAYER_EVENT_BUTT
} RKADK_PLAYER_EVENT_E;
/* snap shot data */
typedef struct {
RKADK_U32 u32Width;
RKADK_U32 u32Height;
RKADK_U32 u32DataLen;
RKADK_U8 *pu8DataBuf;
} RKADK_PLAYER_SNAPSHOT_S;
/* snap shot data recv callback */
typedef void (*RKADK_PPLAYER_SNAPSHOT_RECV_FN)(
RKADK_PLAYER_SNAPSHOT_S *pstData);
typedef RKADK_VOID (*RKADK_PLAYER_EVENT_FN)(RKADK_MW_PTR pPlayer,
RKADK_PLAYER_EVENT_E enEvent,
RKADK_VOID *pData);
/* Must be consistent with rockit/rk_comm_vo.h -> VO_INTF_SYNC_E */
typedef enum {
RKADK_VO_OUTPUT_PAL = 0, /* PAL standard */
RKADK_VO_OUTPUT_NTSC, /* NTSC standard */
RKADK_VO_OUTPUT_1080P24, /* 1920 x 1080 at 24 Hz. */
RKADK_VO_OUTPUT_1080P25, /* 1920 x 1080 at 25 Hz. */
RKADK_VO_OUTPUT_1080P30, /* 1920 x 1080 at 30 Hz. */
RKADK_VO_OUTPUT_720P50, /* 1280 x 720 at 50 Hz. */
RKADK_VO_OUTPUT_720P60, /* 1280 x 720 at 60 Hz. */
RKADK_VO_OUTPUT_1080I50, /* 1920 x 1080 at 50 Hz, interlace. */
RKADK_VO_OUTPUT_1080I60, /* 1920 x 1080 at 60 Hz, interlace. */
RKADK_VO_OUTPUT_1080P50, /* 1920 x 1080 at 50 Hz. */
RKADK_VO_OUTPUT_1080P60, /* 1920 x 1080 at 60 Hz. */
RKADK_VO_OUTPUT_576P50, /* 720 x 576 at 50 Hz. */
RKADK_VO_OUTPUT_480P60, /* 720 x 480 at 60 Hz. */
RKADK_VO_OUTPUT_1280P60, /* 720 x 1280 at 60 Hz. */
RKADK_VO_OUTPUT_800x600_60, /* VESA 800 x 600 at 60 Hz (non-interlaced) */
RKADK_VO_OUTPUT_1024x768_60, /* VESA 1024 x 768 at 60 Hz (non-interlaced) */
RKADK_VO_OUTPUT_1280x1024_60, /* VESA 1280 x 1024 at 60 Hz (non-interlaced) */
RKADK_VO_OUTPUT_1366x768_60, /* VESA 1366 x 768 at 60 Hz (non-interlaced) */
RKADK_VO_OUTPUT_1440x900_60, /* VESA 1440 x 900 at 60 Hz (non-interlaced) CVT
Compliant */
RKADK_VO_OUTPUT_1280x800_60, /* 1280*800@60Hz VGA@60Hz */
RKADK_VO_OUTPUT_1600x1200_60, /* VESA 1600 x 1200 at 60 Hz (non-interlaced) */
RKADK_VO_OUTPUT_1680x1050_60, /* VESA 1680 x 1050 at 60 Hz (non-interlaced) */
RKADK_VO_OUTPUT_1920x1200_60, /* VESA 1920 x 1600 at 60 Hz (non-interlaced)
CVT (Reduced Blanking) */
RKADK_VO_OUTPUT_640x480_60, /* VESA 640 x 480 at 60 Hz (non-interlaced) CVT */
RKADK_VO_OUTPUT_960H_PAL, /* ITU-R BT.1302 960 x 576 at 50 Hz (interlaced) */
RKADK_VO_OUTPUT_960H_NTSC, /* ITU-R BT.1302 960 x 480 at 60 Hz (interlaced) */
RKADK_VO_OUTPUT_1920x2160_30, /* 1920x2160_30 */
RKADK_VO_OUTPUT_2560x1440_30, /* 2560x1440_30 */
RKADK_VO_OUTPUT_2560x1440_60, /* 2560x1440_60 */
RKADK_VO_OUTPUT_2560x1600_60, /* 2560x1600_60 */
RKADK_VO_OUTPUT_3840x2160_24, /* 3840x2160_24 */
RKADK_VO_OUTPUT_3840x2160_25, /* 3840x2160_25 */
RKADK_VO_OUTPUT_3840x2160_30, /* 3840x2160_30 */
RKADK_VO_OUTPUT_3840x2160_50, /* 3840x2160_50 */
RKADK_VO_OUTPUT_3840x2160_60, /* 3840x2160_60 */
RKADK_VO_OUTPUT_4096x2160_24, /* 4096x2160_24 */
RKADK_VO_OUTPUT_4096x2160_25, /* 4096x2160_25 */
RKADK_VO_OUTPUT_4096x2160_30, /* 4096x2160_30 */
RKADK_VO_OUTPUT_4096x2160_50, /* 4096x2160_50 */
RKADK_VO_OUTPUT_4096x2160_60, /* 4096x2160_60 */
/* For HDMI2.1 */
RKADK_VO_OUTPUT_7680x4320_24, /* 7680x4320_24 */
RKADK_VO_OUTPUT_7680x4320_25, /* 7680x4320_25 */
RKADK_VO_OUTPUT_7680x4320_30, /* 7680x4320_30 */
RKADK_VO_OUTPUT_7680x4320_50, /* 7680x4320_50 */
RKADK_VO_OUTPUT_7680x4320_60, /* 7680x4320_60 */
RKADK_VO_OUTPUT_3840x1080_60, /* For split mode */
RKADK_VO_OUTPUT_1080P120, /* 1920x1080_120 */
RKADK_VO_OUTPUT_USER, /* User timing. */
RKADK_VO_OUTPUT_DEFAULT,
RKADK_VO_OUTPUT_BUTT
} RKADK_VO_INTF_SYNC_E;
/* Must be consistent with rockit/rk_comm_vo.h -> VO_SYNC_INFO_S */
typedef struct {
RKADK_BOOL bSynm; /* RW; sync mode(0:timing,as BT.656; 1:signal,as LCD) */
RKADK_BOOL bIop; /* RW; interlaced or progressive display(0:i; 1:p) */
RKADK_U16 u16Vact; /* RW; vertical active area */
RKADK_U16 u16Vbb; /* RW; vertical back blank porch */
RKADK_U16 u16Vfb; /* RW; vertical front blank porch */
RKADK_U16 u16Hact; /* RW; horizontal active area */
RKADK_U16 u16Hbb; /* RW; horizontal back blank porch */
RKADK_U16 u16Hfb; /* RW; horizontal front blank porch */
RKADK_U16 u16Hmid; /* RW; bottom horizontal active area */
RKADK_U16 u16Bvact; /* RW; bottom vertical active area */
RKADK_U16 u16Bvbb; /* RW; bottom vertical back blank porch */
RKADK_U16 u16Bvfb; /* RW; bottom vertical front blank porch */
RKADK_U16 u16Hpw; /* RW; horizontal pulse width */
RKADK_U16 u16Vpw; /* RW; vertical pulse width */
RKADK_BOOL bIdv; /* RW; inverse data valid of output */
RKADK_BOOL bIhs; /* RW; polarity of horizontal synch signal, 0: negative, 1:
positive */
RKADK_BOOL bIvs; /* RW; polarity of vertical synch signal, 0: negative, 1:
positive */
RKADK_U16 u16FrameRate; /* RW; frame rate of output */
RKADK_U16 u16PixClock; /* RW; pixel clock, the unit is KHZ */
} RKADK_VO_SYNC_INFO_S;
/** video output frameinfo */
typedef struct {
RKADK_U32 u32FrmInfoX;
RKADK_U32 u32FrmInfoY;
RKADK_U32 u32DispWidth;
RKADK_U32 u32DispHeight;
RKADK_U32 u32ImgWidth;
RKADK_U32 u32ImgHeight;
RKADK_U32 u32VoLay;
RKADK_U32 u32VoDev;
RKADK_U32 u32VoChn;
RKADK_U32 u32BorderColor;
RKADK_U32 u32BorderTopWidth;
RKADK_U32 u32BorderBottomWidth;
RKADK_U32 u32BorderLeftWidth;
RKADK_U32 u32BorderRightWidth;
RKADK_BOOL bMirror;
RKADK_BOOL bFlip;
RKADK_U32 u32Rotation; //0: 0, 1: 90, 2: 180, 3: 270
RKADK_VO_FORMAT_E u32VoFormat;
RKADK_VO_INTF_TYPE_E u32EnIntfType;
RKADK_VO_INTF_SYNC_E enIntfSync;
RKADK_VO_SYNC_INFO_S stSyncInfo;
RKADK_VO_SPLICE_MODE_E enVoSpliceMode;
RKADK_U32 u32DispBufLen;
} RKADK_PLAYER_FRAME_INFO_S;
typedef struct {
const char *transport; //udp or tcp, default: udp
RKADK_U32 u32IoTimeout; //timeout (in microseconds) of socket I/O operations
} RKADK_PLAYER_NETWORK_STREAM_CFG_S;
typedef struct {
RKADK_U32 u32FrameBufCnt; //frame buffer cnt(output), default: 3
RKADK_U32 u32StreamBufCnt; //stream buffer cnt(input), default: 8
RKADK_VDEC_DECODE_MODE_E u32DecodeMode; //decode mode, default: video
} RKADK_PLAYER_VDEC_CFG_S;
typedef struct {
RKADK_U32 u32AdecChnId;
RKADK_U32 u32AdecBufCnt;
RKADK_U32 u32AoDevId;
RKADK_U32 u32AoChnId;
RKADK_S32 u32AoChannle; /* AO device channel, default: 2 */
RKADK_S32 u32AoSampleRate; /* If the device has only one sound card, the AI and AO samplerate must be consistent, default: 16000 */
RKADK_U32 u32SpeakerVolume; /* speaker volume, [0,100], default: 0 */
const RKADK_CHAR *pSoundCard; /* Playback sound card, default: hw:0,0 */
} RKADK_PLAYER_AUDIO_CFG_S;
typedef struct {
RKADK_U32 u32VencChn;
RKADK_U32 u32MaxWidth; //Support snapshot max width, default 4096
RKADK_U32 u32MaxHeight; //Support snapshot max height, default 4096
RKADK_PPLAYER_SNAPSHOT_RECV_FN pfnDataCallback;
} RKADK_PLAYER_SNAPSHOT_CFG_S;
typedef RKADK_S32 (*RKADK_MPI_MB_FREE_CB)(void *);
typedef struct {
bool bEofFlag;
RKADK_S8 *s8PacketData;
RKADK_S32 s32PacketSize;
RKADK_U32 u32Seq;
RKADK_S64 s64Pts;
//if bypass, must set pFreeCB;
bool bBypass;
RKADK_MPI_MB_FREE_CB pFreeCB;
} RKADK_PLAYER_PACKET;
typedef struct {
const RKADK_CHAR *pFilePath;
RKADK_BOOL bIsNetRTStream;
RKADK_BOOL bVideoExist;
RKADK_BOOL bAudioExist;
//video param
RKADK_CODEC_TYPE_E enVCodecType;
RKADK_U32 u32Width;
RKADK_U32 u32Height;
RKADK_FORMAT_E enPixFmt; //output pixel format
RKADK_U32 u32FrameRate;
//audio param
RKADK_CODEC_TYPE_E enACodecType;
RKADK_S32 u32BitWidth;
RKADK_S32 u32SampleRate;
RKADK_S32 u32Channel;
} RKADK_PLAYER_DATA_PARAM_S;
/** player configuration */
typedef struct {
RKADK_BOOL bEnableVideo;
RKADK_BOOL bEnableAudio;
RKADK_BOOL bEnableThirdDemuxer;
RKADK_PLAYER_FRAME_INFO_S stFrmInfo;
RKADK_PLAYER_NETWORK_STREAM_CFG_S stNetStreamCfg;
RKADK_PLAYER_VDEC_CFG_S stVdecCfg;
RKADK_PLAYER_AUDIO_CFG_S stAudioCfg;
RKADK_PLAYER_SNAPSHOT_CFG_S stSnapshotCfg;
RKADK_BOOL bEnableBlackBackground;
RKADK_PLAYER_EVENT_FN pfnPlayerCallback;
} RKADK_PLAYER_CFG_S;
/**
* @brief create the player
* @param[in] pstPlayCfg : player config
* @param[out] ppPlayer : RKADK_MW_PTR*: handle of the player
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Create(RKADK_MW_PTR *ppPlayer,
RKADK_PLAYER_CFG_S *pstPlayCfg);
/**
* @brief destroy the player
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Destroy(RKADK_MW_PTR pPlayer);
/**
* @brief Set the parameters of the data to be played, when enable third-party demuxer
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[in] pstDataParam : data parameters
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_SetDataParam(RKADK_MW_PTR pPlayer,
RKADK_PLAYER_DATA_PARAM_S *pstDataParam);
/**
* @brief set the file for playing
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[in] filePath : RKADK_CHAR: media file path
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_SetDataSource(RKADK_MW_PTR pPlayer,
const RKADK_CHAR *pszfilePath);
/**
* @brief prepare for the playing
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Prepare(RKADK_MW_PTR pPlayer);
/**
* @brief do play of the stream
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Play(RKADK_MW_PTR pPlayer);
/**
* @brief stop the stream playing, and release the resource
* @param[in] pPlayer : void *: handle of the player
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Stop(RKADK_MW_PTR pPlayer);
/**
* @brief pause the stream playing
* @param[in] hPlayer : RKADK_MW_PTR: handle of the player
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Pause(RKADK_MW_PTR pPlayer);
/**
* @brief seek by the time
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[in] s64TimeInMs : RKADK_S64: seek time
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_Seek(RKADK_MW_PTR pPlayer, RKADK_S64 s64TimeInMs);
/**
* @brief get the current play status
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[out] penState : RKADK_LITEPLAYER_STATE_E*: play state
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_GetPlayStatus(RKADK_MW_PTR pPlayer,
RKADK_PLAYER_STATE_E *penState);
/**
* @brief get the current frame number
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @retval frame num
*/
RKADK_S32 RKADK_PLAYER_GetSendFrameNum(RKADK_MW_PTR pPlayer);
/**
* @brief get the current play file duration(ms)
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[out] pDuration : play duration(ms)
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_GetDuration(RKADK_MW_PTR pPlayer, RKADK_U32 *pDuration);
/**
* @brief get the current play file duration(ms)
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @retval current position(ms)
*/
RKADK_S64 RKADK_PLAYER_GetCurrentPosition(RKADK_MW_PTR pPlayer);
RKADK_S32 RKADK_PLAYER_Snapshot(RKADK_MW_PTR pPlayer);
RKADK_S32 RKADK_PLAYER_SendAudioPacket(RKADK_MW_PTR pPlayer,
RKADK_PLAYER_PACKET *pstPacket);
RKADK_S32 RKADK_PLAYER_SendVideoPacket(RKADK_MW_PTR pPlayer,
RKADK_PLAYER_PACKET *pstPacket);
/**
* @brief set vdec cache frames waterline
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[in] u32VdecWaterline : vdec cache frames waterline, must be less than vdec (u32FrameBufCnt + u32StreamBufCnt)
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_SetVdecWaterline(RKADK_MW_PTR pPlayer, RKADK_U32 u32VdecWaterline);
/**
* @brief set ao volume
* @param[in] pPlayer : RKADK_MW_PTR: handle of the player
* @param[in] s32Volume : ao volume
* @retval 0 success, others failed
*/
RKADK_S32 RKADK_PLAYER_SetAoVolume(RKADK_MW_PTR pPlayer, RKADK_S32 s32Volume);
#ifdef __cplusplus
}
#endif
#endif
Reference in New Issue View Git Blame Copy Permalink