Rockchip RKADK 应用开发指南

以 Rockchip RKADK V2.3.2 中英文原稿为依据，保留 14 章技术内容、API、类型定义和示例。本文作为 ArmSoM 平台参考，须核对具体开发板、SoC、SDK/BSP、内核和外设；不代表所有 ArmSoM 板卡均支持。文中示例来自原稿，未执行命令或硬件测试。

中文第 3 章包含 3.1 概述、3.2 API 参考和 3.3 数据类型；英文将概述放在章标题下，API 和类型分别为 3.1、3.2。本页保留各原稿编号。中文 3.3.6 标题为 RKADK_MUXER_MANUAL_SPLIT_ATTR_S，英文 3.2.6 为 RKADK_REC_MANUAL_SPLIT_ATTR_S；须按实际 SDK 头文件核对，不能仅按标题替换类型。英文 RKADK_RECORD_Single_Stop 原稿声明将 RKADK_STREAM_TYPE_EenStrmType 连写，正文保留原文；使用前按 SDK 核对类型与参数的分隔。

两稿发布日期均为 2025-08-04。原稿类型节还存在标题与 typedef 名称不一致：手动切分结构体定义结尾为 MUXER_MANUAL_SPLIT_ATTR_S，下一节手动切分类型枚举却结尾为 RKADK_MUXER_MANUAL_SPLIT_ATTR_S。原样保留，不能直接视为可编译的 SDK 头文件。RKADK_MUXER_Disbale、librokadk.so、RGBA9888 及播放器平台列表中的 RV1103/RV1103 也是原稿写法；请核对实际 SDK。跨行函数声明中恢复空格，未改动参数、指针或标识符。

1. 系统概述

rkadk提供了基础通用组件,如录像、拍照、播放、预览等,简化了应用开发难度,支持快速开发音视频录制相关应 用软件。 该组件仅支持单进程的功能实现,如无特殊说明,不支持多进程同时使用。

1.1 版本说明

1.x.x版本:在rkmedia和rockit的基础上做的进一步封装,对应master仓库。

2.x.x版本:在rockit的基础上做的进一步封装,对应develop仓库。

2. 录像

2.1 概述

提供基本的录像功能,向产品层提供如下功能: 录像任务的创建与销毁 录像任务的启动与停止 手动切分录像文件 缩时录像 预录像 画中画录像 录像任务通过参数模块获取Video和Audio信息,启停VENC,启停AENC;调用封装模块创建录像文件,写帧到文件。 每个录像任务对应一个或多个录像文件,每个文件必须对应一路视频编码通道,如果需要录制音频,需要加上一路音 频编码通道。 同一录像任务下的多个录像文件,具有相同的录像类型,相同的切分条件,缩时录像模式下还具有相同的缩时间隔; 可以配置不同的录像时间。 Post AI ISP:RV1106/RV1126/RV1109芯片支持通过AI ISP对VI输出图片进行微光降噪及智能增强处理,可在暗光、 弱光环境下,依然呈现出无拖影、低噪点、更清晰的画面。

2.2 API参考

2.2.1 RKADK_RECORD_Create

描述

创建录像任务。

语法

RKADK_S32 RKADK_RECORD_Create(RKADK_RECORD_ATTR_S *pstRecAttr, RKADK_MW_PTR *ppRecorder);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

每个录像任务最大支持同时录制2个录像文件。 每个录像文件最少有1路视频流,最大支持同时封装1路视频流和1路音频流。 不支持重复创建同一任务。 创建录像任务后,需要调用RKADK_RECORD_Start才会开始录像。 如果需要使能画中画,必须在RKADK_RECORD_Create时,就通过stPipAttr先使能,才会创建画中画通路。

举例

rkadk_record_test。

相关主题

RKADK_RECORD_Destroy。

2.2.2 RKADK_RECORD_Destroy

描述

销毁录像任务。

语法

RKADK_S32 RKADK_RECORD_Destroy(RKADK_MW_PTR pRecorder);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_Destroy接口。 只能销毁已创建的录像任务,不支持重复销毁同一录像任务。

举例

rkadk_record_test。

相关主题

RKADK_RECORD_Create

2.2.3 RKADK_RECORD_Start

描述

启动录像任务。

语法

RKADK_S32 RKADK_RECORD_Start(RKADK_MW_PTR pRecorder);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_Start接口。 支持在停止录像任务后重新启动录像任务。

举例

rkadk_record_test。

相关主题

RKADK_RECORD_Stop

2.2.4 RKADK_RECORD_Stop

描述

停止录像任务。

语法

RKADK_S32 RKADK_RECORD_Stop(RKADK_MW_PTR pRecorder);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_Stop接口。 不支持重复停止同一录像任务。

举例

rkadk_record_test。

相关主题

RKADK_RECORD_Start

2.2.5 RKADK_RECORD_Single_Start

描述

启动指定码流的录像任务。

语法

RKADK_S32 RKADK_RECORD_Single_Start(RKADK_MW_PTR pRecorder, RKADK_STREAM_TYPE_E enStrmType);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_Single_Start接口。 和RKADK_RECORD_Single_Stop配套使用。

支持在停止录像任务后重新启动录像任务。

举例

rkadk_record_test。

相关主题

RKADK_RECORD_Single_Stop

2.2.6 RKADK_RECORD_Single_Stop

描述

停止指定码流的录像任务。

语法

RKADK_S32 RKADK_RECORD_Single_Stop(RKADK_MW_PTR pRecorder, RKADK_STREAM_TYPE_EenStrmType);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_Stop接口。 和RKADK_RECORD_Single_Start配套使用。 不支持重复停止同一录像任务。

举例

rkadk_record_test。

相关主题

RKADK_RECORD_Single_Start

2.2.7 RKADK_RECORD_Reset

描述

重新配置录像任务 。

语法

RKADK_S32 RKADK_RECORD_Reset(RKADK_MW_PTR *ppRecorder);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_Reset 接口。 切换分辨率、帧率、比特率、编码类型、录像类型时,结合RKADK_PARAM_SetCamParam API重置ini文件中 Record模块的参数。 RV1126/RV1109、RK3576不支持动态切换分辨率和编码类型,需要先RKADK_RECORD_Destroy,然后配置 新的分辨率或者编码类型,再重新RKADK_RECORD_Create。 如果Record和其他模块复用VI通道,需要同时切换Record和复用模块的分辨率,否则会导致VI和VENC分辨率 不匹配。

举例

rkadk_record_test。

相关主题

无

2.2.8 RKADK_RECORD_ManualSplit

描述

手动切分录像文件。

语法

RKADK_S32 RKADK_RECORD_ManualSplit(RKADK_MW_PTR pRecorder, RKADK_REC_MANUAL_SPLIT_ATTR_S *pstSplitAttr);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

创建录像任务后,才能使用RKADK_RECORD_ManualSplit接口。 支持在手动切分录像文件未结束时,重复手动切分录像文件。

举例

rkadk_record_test。

相关主题

无

2.2.9 RKADK_RECORD_GetAencChn

描述

获取录像AENC通道号。

语法

RKADK_S32 RKADK_RECORD_GetAencChn();

返回值

录像所使用的AENC通道号。

需求

头文件:rkadk_record.h 库文件:librkadk.so

2.2.10 RKADK_GetThmInMp4

描述

从MP4文件中获取缩略图数据。

语法

RKADK_S32 RKADK_GetThmInMp4(RKADK_U32 u32CamId, RKADK_CHAR *pszFileName, RKADK_U8 *pu8Buf, RKADK_U32 *pu32Size);

参数

返回值

需求

头文件:rkadk_thumb.h 库文件:librkadk.so

举例

rkadk_thumb_test

相关主题

无

2.2.11 RKADK_GetThmInMp4Ex

描述

MP4获取缩略图扩展接口,从MP4文件中获取缩略图数据,支持指定输出缩略图的类型和分辨率。必须和 RKADK_ThmBufFree配套使用。

语法

RKADK_S32 RKADK_GetThmInMp4Ex(RKADK_U32 u32CamId, RKADK_CHAR *pszFileName, RKADK_THUMB_ATTR_S *pstThumbAttr);

参数

返回值

需求

头文件:rkadk_thumb.h 库文件:librkadk.so

举例

rkadk_thumb_test

相关主题

RKADK_ThmBufFree

2.2.12 RKADK_ThmBufFree

描述

释放RKADK_GetThmInMp4Ex申请的内存。必须和RKADK_GetThmInMp4Ex配套使用。

语法

RKADK_S32 RKADK_ThmBufFree(RKADK_THUMB_ATTR_S *pstThumbAttr);

参数

返回值

需求

头文件:rkadk_thumb.h 库文件:librkadk.so

举例

rkadk_thumb_test

相关主题

RKADK_GetThmInMp4Ex

2.2.13 RKADK_RECORD_SetRotation

描述

设置Record旋转。

语法

RKADK_S32 RKADK_RECORD_SetRotation(RKADK_MW_PTR pRecorder, ROTATION_E enRotation, RKADK_STREAM_TYPE_E enStreamType);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

举例

rkadk_record_test

2.2.14 RKADK_RECORD_ToggleMirror

描述

设置Record Mirror。

语法

RKADK_S32 RKADK_RECORD_ToggleMirror(RKADK_MW_PTR pRecorder, RKADK_STREAM_TYPE_E enStrmType, bool mirror);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

2.2.15 RKADK_RECORD_ToggleFlip

描述

设置Record Flip。

语法

RKADK_S32 RKADK_RECORD_ToggleFlip(RKADK_MW_PTR pRecorder, RKADK_STREAM_TYPE_E enStrmType, bool flip);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

2.2.16 RKADK_RECORD_FileCacheInit

描述

File Cache初始化,旨在使写文件更平滑,使能File Cache之后,文件通过DirectIO方式写入存储设备,内核中的 Cache机制不生效。

语法

RKADK_S32 RKADK_RECORD_FileCacheInit(FILE_CACHE_ARG *pstFileCacheAttr)

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

File Cache默认不开启。 使能File Cache,必须设置file_cache_env环境变量

export file_cache_env=1

如果使能File Cache,则须在RKADK_RECORD_Create之前调用该接口,且只需调用一次,否则无需调用。 使能File Cache,会有额外的内存消耗,内存大小由u32TotalCache决定。 该接口必须和RKADK_RECORD_FileCacheDeInit配套使用

举例

rkadk_record_test

2.2.17 RKADK_RECORD_FileCacheDeInit

描述

File Cache反初始化。

语法

RKADK_S32 RKADK_RECORD_FileCacheDeInit();

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

该接口必须和RKADK_RECORD_FileCacheInit配套使用。 如果使能File Cache,则需在RKADK_RECORD_Destroy之后调用该接口,否则无需调用。 rkadk_record_test

2.2.18 RKADK_RECORD_FileCacheSetMode

描述

设置File Cache录像类型。

语法

void RKADK_RECORD_FileCacheSetMode(RKADK_REC_TYPE_E enRecType);

参数

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

使能File Cache 后,切换录像类型时,必须调用该API像File Cache 设置新的录像类型。 rkadk_aov_record_test

2.2.19 RKADK_MEDIA_EnablePostIsp

描述

使能Post AI ISP,除接口外还可以通过配置sensor ini中的post_aiisp使能Post AI ISP。

语法

RKADK_S32 RKADK_MEDIA_EnablePostIsp(RKADK_U32 u32CamId, RKADK_STREAM_TYPE_E enStrmType, RKADK_POST_ISP_ATTR_S *pstPostIspAttr);

参数

返回值

需求

头文件:rkadk_media_comm.h 库文件:librkadk.so

2.2.20 RKADK_MEDIA_SetPostIspAttr

描述

动态设置Post AI ISP属性。

语法

RKADK_S32 RKADK_MEDIA_SetPostIspAttr(RKADK_U32 u32CamId, RKADK_STREAM_TYPE_E enStrmType, bool bEnable, RKADK_POST_ISP_ATTR_S *pstPostIspAttr);

参数

返回值

需求

头文件:rkadk_media_comm.h 库文件:librkadk.so

注意

必须先使能Post AI ISP之后,才能调用RKADK_MEDIA_SetPostIspAttr,否则会返回失败。

2.2.21 RKADK_RECORD_SetPipAttr

描述

动态设置画中画属性。

语法

RKADK_S32 RKADK_RECORD_SetPipAttr(RKADK_MW_PTR pRecorder, RKADK_PIP_ATTR_S *pstPipAttr);

参数

返回值

需求

头文件:rkadk_record.h 库文件:librkadk.so

注意

如果需要使能画中画,必须在RKADK_RECORD_Create时,就通过stPipAttr先使能,才会创建画中画通路。

2.3 数据类型

录像模块主要提供以下数据类型: RKADK_MW_PTR:录像任务指针 RECORD_FILE_NUM_MAX:单个录像任务同时录制最大文件个数 RKADK_REC_EVENT_CALLBACK_FN:事件回调函数指针 RKADK_REC_TYPE_E:录像类型枚举 RKADK_REC_REQUEST_FILE_NAMES_FN:请求录像文件名函数指针 RKADK_REC_PTS_CALLBACK_FN:视频帧时间戳回调函数指针 RKADK_RECORD_ATTR_S:录像任务属性结构体 RKADK_REC_MANUAL_SPLIT_ATTR_S:手动切分属性结构体

FILE_CACHE_ARG:File Cache属性结构体 RKADK_POST_ISP_ATTR_S:Post AI ISP 属性结构体 RKADK_MOUMNT_SDCARD_FN:Sdcard挂载函数指针 RKADK_AOV_ATTR_S:AOV属性结构体 RKADK_PIP_ATTR_S:画中画属性结构体 RKADK_THIRD_MUXER_ATTR_S:第三方Muxer属性结构体

2.3.1 公共数据类型

说明

基本数据类型定义。

定义

typedef unsigned char RKADK_U8;
typedef unsigned short RKADK_U16;
typedef unsigned int RKADK_U32;

typedef signed char RKADK_S8;
typedef short RKADK_S16;
typedef int RKADK_S32;

typedef unsigned long RKADK_UL;
typedef signed long RKADK_SL;

typedef float RKADK_FLOAT;
typedef double RKADK_DOUBLE;

#ifndef _M_IX86
typedef unsigned long long RKADK_U64;
typedef long long RKADK_S64;
#else
typedef unsigned __int64 RKADK_U64;
typedef __int64 RKADK_S64;
#endif

typedef char RKADK_CHAR;
#define RKADK_VOID void

typedef unsigned int RKADK_HANDLE;

typedef RKADK_VOID *RKADK_MW_PTR;

typedef char (*ARRAY_FILE_NAME)[RKADK_MAX_FILE_PATH_LEN];

typedef enum {
  RKADK_FALSE = 0,
  RKADK_TRUE = 1,
} RKADK_BOOL;

#ifndef NULL
#define NULL 0L
#endif

#define RKADK_NULL 0L
#define RKADK_SUCCESS 0
#define RKADK_FAILURE (-1)

2.3.2 RKADK_MW_PTR

说明

定义任务指针

定义

typedef RKADK_VOID *RKADK_MW_PTR;

2.3.3 RKADK_MAX_SENSOR_CNT

说明

定义支持的最大Sensor个数,可根据实际情况调整

定义

#define RKADK_MAX_SENSOR_CNT 8

2.3.4 RECORD_FILE_NUM_MAX

说明

定义单个录像任务同时录制最大文件个数

定义

#define RECORD_FILE_NUM_MAX 2

2.3.5 RKADK_REC_EVENT_CALLBACK_FN

说明

定义录像事件回调函数指针。

定义

typedef RKADK_MUXER_EVENT_CALLBACK_FN RKADK_REC_EVENT_CALLBACK_FN;

相关数据类型及接口

RKADK_MUXER_EVENT_CALLBACK_FN

2.3.6 RKADK_REC_TYPE_E

说明

定义录像类型枚举。

定义

typedef RKADK_MUXER_REC_TYPE_E RKADK_REC_TYPE_E;

相关数据类型及接口

RKADK_MUXER_REC_TYPE_E

2.3.7 RKADK_REC_REQUEST_FILE_NAMES_FN

说明

定义请求录像文件名回调函数指针。

定义

typedef RKADK_S32 (*RKADK_REC_REQUEST_FILE_NAMES_FN)(RKADK_MW_PTR pRecorder, RKADK_U32
u32FileCnt, RKADK_CHAR(*paszFilename)[RKADK_MAX_FILE_PATH_LEN]);

成员

相关数据类型及接口

RKADK_MW_PTR RKADK_RECORD_ATTR_S

2.3.8 RKADK_REC_PTS_CALLBACK_FN

说明

定义视频帧时间戳回调函数指针。

定义

typedef RKADK_MUXER_PTS_CALLBACK_FN RKADK_REC_PTS_CALLBACK_FN;

相关数据类型及接口

RKADK_MUXER_PTS_CALLBACK_FN RKADK_RECORD_ATTR_S

2.3.9 RKADK_MOUMNT_SDCARD_FN

说明

定义Sdcard挂载函数指针。

定义

typedef int (*RKADK_MOUMNT_SDCARD_FN)(void);

相关数据类型及接口

RKADK_RECORD_ATTR_S

2.3.10 RKADK_RECORD_ATTR_S

说明

定义录像任务属性结构体。

定义

typedef struct {
  RKADK_S32 s32CamID;                                  /* camera id */
  RKADK_U32 u32FragKeyFrame;
  RKADK_REC_REQUEST_FILE_NAMES_FN pfnRequestFileNames; /* rec callbak */
  RKADK_REC_EVENT_CALLBACK_FN pfnEventCallback;        /* event callbak */
  RKADK_AOV_ATTR_S stAovAttr;
  RKADK_POST_ISP_ATTR_S *pstPostIspAttr;
  RKADK_MOUMNT_SDCARD_FN pfnMountSdcard;
  RKADK_PIP_ATTR_S stPipAttr[RECORD_FILE_NUM_MAX];
  RKADK_U32 u32GetThumbTime[RECORD_FILE_NUM_MAX];      /* get thumbnail delay time(ms) when
enbale file cache, default: 3000(ms) */
  RKADK_THIRD_MUXER_ATTR_S *pstThirdMuxerAttr;         /* third party muxer attr */
} RKADK_RECORD_ATTR_S;

成员

相关数据类型及接口

RKADK_REC_EVENT_CALLBACK_FN RKADK_REC_REQUEST_FILE_NAMES_FN RKADK_MOUMNT_SDCARD_FN RKADK_AOV_ATTR_S RKADK_POST_ISP_ATTR_S RKADK_PIP_ATTR_S RKADK_THIRD_MUXER_ATTR_S RKADK_RECORD_Create

2.3.11 RKADK_REC_MANUAL_SPLIT_ATTR_S

说明

定义手动切分属性结构体。

定义

typedef RKADK_MUXER_MANUAL_SPLIT_ATTR_S RKADK_REC_MANUAL_SPLIT_ATTR_S;

相关数据类型及接口

RKADK_MUXER_MANUAL_SPLIT_ATTR_S RKADK_RECORD_ManualSplit

2.3.12 FILE_CACHE_ARG

说明

定义File Cache属性结构体。

定义

typedef struct _FILE_CACHE_ARG {
  const char *sdcard_path;
  int write_cache;  /* write cache size(byte), default 1M */
  int total_cache;  /* total cache size(byte), default 10M */
  FILE_WRITE_THREAD_ARG write_thread_arg;
  FILE_SDCARD_ARG sdcard_arg;
} FILE_CACHE_ARG;

成员

相关数据类型及接口

RKADK_RECORD_FileCacheInit FILE_WRITE_THREAD_ARG FILE_SDCARD_ARG

2.3.13 FILE_WRITE_THREAD_ARG

说明

定义写文件线程属性结构体。

定义

typedef enum _FILE_SCHED_POLICY {
  FILE_SCHED_OTHER = 0,
  FILE_SCHED_BATCH,
  FILE_SCHED_IDLE,
  FILE_SCHED_FIFO,      /* sched_priority[1, 99] */
  FILE_SCHED_RR,        /* sched_priority[1, 99] */
} FILE_SCHED_POLICY;

typedef struct _FILE_WRITE_THREAD_ARG {
  FILE_SCHED_POLICY sched_policy;
  int priority; /* SCHED_OTHER/SCHED_IDLE/SCHED_BATCH inoperative */
} FILE_WRITE_THREAD_ARG;

成员

相关数据类型及接口

FILE_CACHE_ARG

2.3.14 FILE_SDCARD_ARG

说明

定义sdcard属性结构体。

定义

typedef struct _FILE_SDCARD_ARG {
    FILE_CACHE_SDCARD_LOCK lock;
    FILE_CACHE_SDCARD_UNLOCK unlock;
    FILE_CACHE_MOUMNT_SDCARD mount_sdcard;
    FILE_CACHE_UMOUMNT_SDCARD umount_sdcard;
} FILE_SDCARD_ARG;

成员

相关数据类型及接口

FILE_CACHE_ARG

2.3.15 RKADK_POST_ISP_ATTR_S

说明

定义Post AI ISP属性结构体。

定义

typedef struct {
  AIISP_CALLBACK_FUNC_S stAiIspCallback;      /* post isp callback function */
  const RK_CHAR        *pModelFilePath;       /* post isp model file path   */
  RK_U32                u32FrameBufCnt;       /* RW; frame buffer cnt    */
} RKADK_POST_ISP_ATTR_S;

成员

相关数据类型及接口

RKADK_MEDIA_EnablePostIsp RKADK_MEDIA_SetPostIspAttr

2.3.16 RKADK_AOV_ATTR_S

说明

定义AOV属性结构体。

定义

typedef struct {
  RKADK_ISP_WAKE_UP_PAUSE_FN pfnSingleFrame;
  RKADK_ISP_WAKE_UP_RESUME_FN pfnMultiFrame;
} RKADK_AOV_ATTR_S;

成员

相关数据类型及接口

RKADK_RECORD_Create

2.3.17 RKADK_PIP_ATTR_S

说明

定义画中画属性结构体。

定义

typedef struct {
  RKADK_BOOL bEnablePip;                      /* enable picture-in-picture */
  RKADK_U32 u32AvsGrpId;                      /* avs group id [0, AVS_MAX_GRP_NUM)] */
  RKADK_U32 u32AvsBufCnt;                     /* default 2, min value 2 */
  RKADK_U32 u32SubCamId;                      /* subwindow camera id */
  RKADK_STREAM_TYPE_E enSubStreamType;        /* subwindow stream type */
  RKADK_RECT_S stSubRect;                     /* The subwindow is based on the display area
of the main window */
} RKADK_PIP_ATTR_S;

成员

相关数据类型及接口

RKADK_RECORD_Create RKADK_RECORD_SetPipAttr

3. 视频封装

3.1 概述

提供基本的视频封装功能,向产品层提供如下功能: 封装器的创建与销毁 封装器的启动与停止 手动切分文件 每个封装器最多支持同时封装两个文件。 每个封装文件至少包含一路视频流,最大支持同时封装一路视频流和一路音频流。 支持同时创建多个封装器。 支持第三方码流封装。

3.2 API参考

3.2.1 RKADK_MUXER_Create

描述

创建封装器。

语法

RKADK_S32 RKADK_MUXER_Create(RKADK_MUXER_ATTR_S *pstMuxerAttr, RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

不支持重复创建同一封装器。 创建封装器后,需要先调用RKADK_MUXER_Enable使能封装器,再调用RKADK_MUXER_Start开始封装。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Destroy。

3.2.2 RKADK_MUXER_Destroy

描述

销毁封装器。

语法

RKADK_S32 RKADK_MUXER_Destroy(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

只能销毁已创建的封装器,不支持重复销毁同一封装器。 销毁封装器前,需要先调用RKADK_MUXER_Stop停止封装器,再调用RKADK_MUXER_Disable Disable 封装 器。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Create

3.2.3 RKADK_MUXER_Enable

描述

使能封装器。

语法

RKADK_S32 RKADK_MUXER_Enable(RKADK_MUXER_ATTR_S *pstMuxerAttr,, RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

和RKADK_MUXER_Disable配套使用。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Disbale。

3.2.4 RKADK_MUXER_Disable

描述

Disable封装器。

语法

RKADK_S32 RKADK_MUXER_Disable(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

和RKADK_MUXER_Enable配套使用。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Enable

3.2.5 RKADK_MUXER_Start

描述

启动封装器。

语法

RKADK_S32 RKADK_MUXER_Start(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

支持在停止封装器后重新启动封装器。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Stop

3.2.6 RKADK_MUXER_Stop

描述

停止封装器。

语法

RKADK_S32 RKADK_MUXER_Stop(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

不支持重复停止同一封装器。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Start

3.2.7 RKADK_MUXER_Single_Start

描述

启动指定码流的封装器。

语法

RKADK_S32 RKADK_MUXER_Single_Start(RKADK_MW_PTR pHandle, int s32MuxerId, int s32VencChn);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

和RKADK_MUXER_Single_Stop配套使用。 支持在停止封装器后重新启动封装器。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Single_Stop

3.2.8 RKADK_MUXER_Single_Stop

描述

停止指定码流的封装器。

语法

RKADK_S32 RKADK_MUXER_Single_Stop(RKADK_MW_PTR pHandle, int s32MuxerId, int s32VencChn);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

和RKADK_MUXER_Single_Start配套使用。 不支持重复停止同一封装器。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Single_Start

3.2.9 RKADK_MUXER_ManualSplit

描述

手动切分文件。

语法

RKADK_S32 RKADK_MUXER_ManualSplit(RKADK_MW_PTR pHandle, RKADK_MUXER_MANUAL_SPLIT_ATTR_S *pstSplitAttr);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

支持在手动切分文件未结束时,重复手动切分文件。

举例

rkadk_muxer_test

3.2.10 RKADK_MUXER_Reset

描述

重新配置封装器 。

语法

RKADK_S32 RKADK_MUXER_Reset(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

RKADK_MUXER_Reset之前,先调用RKADK_MUXER_SetResetState设置封装器为Reset状态; RKADK_MUXER_Reset之后,需调用RKADK_MUXER_ResetParam重新配置封装器参数; RKADK_MUXER_ResetParam之后,重新调用RKADK_MUXER_SetResetState设置封装器为非Reset状态。

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_ResetParam RKADK_MUXER_SetResetState

3.2.11 RKADK_MUXER_ResetParam

描述

重新配置封装器参数 。

语法

RKADK_S32 RKADK_MUXER_ResetParam(RKADK_MUXER_ATTR_S *pstMuxerAttr, RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Reset RKADK_MUXER_SetResetState

3.2.12 RKADK_MUXER_SetResetState

描述

设置封装器Reset状态 。

语法

void RKADK_MUXER_SetResetState(RKADK_MW_PTR pHandle, bool state);

参数

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

举例

rkadk_muxer_test。

相关主题

RKADK_MUXER_Reset RKADK_MUXER_ResetParam

3.2.13 RKADK_MUXER_BuildInThumb

描述

内置缩略图到文件 。

语法

RKADK_S32 RKADK_MUXER_BuildInThumb(RKADK_MW_PTR pHandle, RKADK_MUXER_THUMB_INFO_S stThumbInfo);

参数

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

注意

如果需要内置缩略图到文件,RKADK_MUXER_Create时需要正确配置缩略图分辨率,以便预留缩略图存储空 间。 只有MP4文件支持内置缩略图。

举例

rkadk_muxer_test。

3.2.14 RKADK_MUXER_WriteVideoFrame

描述

写视频流数据。

语法

int RKADK_MUXER_WriteVideoFrame(RKADK_MUXER_DATA_S stData, void *handle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

举例

rkadk_muxer_test。

3.2.15 RKADK_MUXER_WriteAudioFrame

描述

写音频流数据。

语法

int RKADK_MUXER_WriteAudioFrame(RKADK_MUXER_DATA_S stData, void *handle);

参数

返回值

需求

头文件:rkadk_muxer.h 库文件:librkadk.so

举例

rkadk_muxer_test。

3.3 数据类型

视频封装模块主要提供以下数据类型: RKADK_MUXER_FILE_TYPE_E:封装文件类型枚举 RKADK_MUXER_EVENT_E:封装事件类型枚举 RKADK_MUXER_FILE_EVENT_INFO_S:文件相关事件信息结构体 RKADK_MUXER_EVENT_INFO_S:封装事件信息结构体 RKADK_MUXER_EVENT_CALLBACK_FN:事件回调函数指针 RKADK_MUXER_MANUAL_SPLIT_ATTR_S:手动切分属性结构体 RKADK_MUXER_MANUAL_SPLIT_TYPE_E:手动切分文件枚举类型 RKADK_MUXER_ATTR_S:封装器属性结构体 RKADK_MUXER_REC_TYPE_E:封装录像类型枚举 RKADK_MUXER_TYPE_E:封装类型枚举 RKADK_MUXER_REQUEST_FILE_NAME_CB:请求文件名函数指针 RKADK_MUXER_STREAM_ATTR_S:封装码流属性结构体 RKADK_MUXER_PRE_RECORD_ATTR_S:预录属性结构体 RKADK_MUXER_PRE_RECORD_MODE_E:预录模式枚举 RKADK_MUXER_PTS_CALLBACK_FN:视频帧时间戳回调函数指针 RKADK_MUXER_PTS_INFO_S:时间戳信息结构体 RKADK_MUXER_DATA_S:封装数据结构体 RKADK_MUXER_THUMB_INFO_S:缩略图信息结构体

3.3.1 RKADK_MUXER_FILE_TYPE_E

说明

定义封装文件类型枚举

定义

typedef enum rkMUXER_TYPE_E {
  RKADK_MUXER_TYPE_MP4 = 0,
  RKADK_MUXER_TYPE_MPEGTS,
  RKADK_MUXER_TYPE_FLV,
  RKADK_MUXER_TYPE_BUTT
} RKADK_MUXER_FILE_TYPE_E;

成员

注意

只有MP4文件支持内置缩略图。

3.3.2 RKADK_MUXER_EVENT_E

说明

定义录像事件枚举类型。

定义

typedef enum rkMUXER_EVENT_E {
  RKADK_MUXER_EVENT_STREAM_START = 0,
  RKADK_MUXER_EVENT_STREAM_STOP,
  RKADK_MUXER_EVENT_FILE_BEGIN,
  RKADK_MUXER_EVENT_FILE_END,
  RKADK_MUXER_EVENT_MANUAL_SPLIT_END,
  RKADK_MUXER_EVENT_ERR_CREATE_FILE_FAIL,
  RKADK_MUXER_EVENT_ERR_WRITE_FILE_FAIL,
  RKADK_MUXER_EVENT_FILE_WRITING_SLOW,
  RKADK_MUXER_EVENT_ERR_CARD_NONEXIST,
  RKADK_MUXER_EVENT_BUTT
} RKADK_MUXER_EVENT_E;

成员

相关数据类型及接口

RKADK_MUXER_EVENT_INFO_S

3.3.3 RKADK_MUXER_FILE_EVENT_INFO_S

说明

定义文件相关事件信息结构体。

定义

typedef struct {
  RK_CHAR asFileName[RKADK_MUXER_FILE_NAME_LEN];
  RK_U32 u32Duration; // ms
} RKADK_MUXER_FILE_EVENT_INFO_S;

成员

相关数据类型及接口

RKADK_MUXER_EVENT_INFO_S

3.3.4 RKADK_MUXER_EVENT_INFO_S

说明

定义封装事件信息结构体。

定义

typedef struct {
  RKADK_MUXER_EVENT_E enEvent;
  union {
    RKADK_MUXER_FILE_EVENT_INFO_S stFileInfo;
    RKADK_MUXER_ERROR_EVENT_INFO_S stErrorInfo;
  } unEventInfo;
} RKADK_MUXER_EVENT_INFO_S;

成员

相关数据类型及接口

RKADK_MUXER_EVENT_E RKADK_MUXER_FILE_EVENT_INFO_S RKADK_MUXER_EVENT_CALLBACK_FN

3.3.5 RKADK_MUXER_EVENT_CALLBACK_FN

说明

定义录像事件回调函数指针。

定义

typedef RKADK_VOID (*RKADK_MUXER_EVENT_CALLBACK_FN)(
    RKADK_MW_PTR pHandle, const RKADK_MUXER_EVENT_INFO_S *pstEventInfo);

相关数据类型及接口

RKADK_MUXER_EVENT_INFO_S

3.3.6 RKADK_MUXER_MANUAL_SPLIT_ATTR_S

说明

定义手动切分属性结构体。

定义

typedef struct {
  RKADK_MUXER_MANUAL_SPLIT_TYPE_E enManualType;               /* maual split type */
  RKADK_U32 u32DurationSec; /* file duration of manual split file */
} MUXER_MANUAL_SPLIT_ATTR_S;

成员

相关数据类型及接口

RKADK_MUXER_MANUAL_SPLIT_TYPE_E RKADK_MUXER_ManualSplit

3.3.7 RKADK_MUXER_MANUAL_SPLIT_TYPE_E

说明

定义手动切分类型。

定义

typedef enum {
  MUXER_PRE_MANUAL_SPLIT,      /* pre manual split type */
  MUXER_NORMAL_MANUAL_SPLIT,   /* normal manual split type */
} RKADK_MUXER_MANUAL_SPLIT_ATTR_S;

成员

相关数据类型及接口

RKADK_MUXER_MANUAL_SPLIT_ATTR_S

3.3.8 RKADK_THIRD_MUXER_ATTR_S

说明

定义第三方Muxer属性结构体。

定义

typedef struct {
  RKADK_THIRD_MUXER_INIT_FN pfnMuxerInit;
  RKADK_THIRD_MUXER_DEINIT_FN pfnMuxerDeinit;
  RKADK_THIRD_MUXER_WRITE_VIDEO_FN pfnWriteVideo;
  RKADK_THIRD_MUXER_WRITE_AUDIO_FN pfnWriteAudio;
  RKADK_THIRD_MUXER_GET_THUMB_POS_FN pfnGetThumbPos;
} RKADK_THIRD_MUXER_ATTR_S;

成员

相关数据类型及接口

RKADK_MUXER_ATTR_S

3.3.9 RKADK_MUXER_ATTR_S

说明

定义封装器属性结构体。

定义

typedef struct {
  RKADK_U32 u32CamId;
  RKADK_MUXER_REC_TYPE_E enRecType;
  RKADK_MUXER_TYPE_E enMuxerType;
  RKADK_U32 u32StreamCnt; /* stream cnt */
  RKADK_U32 u32FragKeyFrame;
  RKADK_MUXER_STREAM_ATTR_S
  astStreamAttr[RKADK_MUXER_STREAM_MAX_CNT]; /* array of stream attr */
  RKADK_MUXER_PRE_RECORD_ATTR_S stPreRecordAttr;
  RKADK_MUXER_REQUEST_FILE_NAME_CB pcbRequestFileNames;
  RKADK_MUXER_EVENT_CALLBACK_FN pfnEventCallback;
  RKADK_MUXER_PTS_CALLBACK_FN pfnPtsCallback;
  RKADK_AOV_ATTR_S stAovAttr;
  RKADK_MOUMNT_SDCARD_FN pfnMountSdcard;
  bool bEnableAiisp;
  RKADK_THIRD_MUXER_ATTR_S *pstThirdMuxerAttr; /* third party muxer attr */
} RKADK_MUXER_ATTR_S;

成员

注意

使能第三方Muxer后,不支持使用RKADK_GetThmInMp4和RKADK_GetThmInMp4Ex获取视频缩略图。

相关数据类型及接口

RKADK_MUXER_REC_TYPE_E RKADK_MUXER_TYPE_E RKADK_MUXER_STREAM_ATTR_S RKADK_MUXER_PRE_RECORD_ATTR_S RKADK_MUXER_REQUEST_FILE_NAME_CB RKADK_MUXER_EVENT_CALLBACK_FN

RKADK_MUXER_PTS_CALLBACK_FN RKADK_AOV_ATTR_S RKADK_MOUMNT_SDCARD_FN RKADK_THIRD_MUXER_ATTR_S RKADK_MUXER_Create RKADK_MUXER_ResetParam

3.3.10 RKADK_MUXER_REC_TYPE_E

说明

定义封装录像类型枚举。

定义

typedef enum {
  RKADK_REC_TYPE_NORMAL = 0, /* normal record */
  RKADK_REC_TYPE_LAPSE, /* time lapse record, record a frame by an fixed time
                           interval */
  RKADK_REC_TYPE_AOV_LAPSE, /* low power time lapse record */
  RKADK_REC_TYPE_BUTT,
} RKADK_MUXER_REC_TYPE_E;

成员

相关数据类型及接口

RKADK_REC_TYPE_E RKADK_MUXER_ATTR_S

注意

仅RV1126、RV1106、RV1126B平台支持使用AOV缩时录像。

3.3.11 RKADK_MUXER_TYPE_E

说明

定义封装类型枚举。

定义

typedef enum {
  RKADK_MUXER_TYPE_RECORD = 0,
  RKADK_MUXER_TYPE_THIRD_STREAM,
} RKADK_MUXER_TYPE_E;

成员

相关数据类型及接口

RKADK_MUXER_ATTR_S

3.3.12 RKADK_MUXER_REQUEST_FILE_NAME_CB

说明

定义请求文件名回调函数指针。

定义

typedef int (*RKADK_MUXER_REQUEST_FILE_NAME_CB)(RKADK_VOID *pHandle, RKADK_CHAR *pcFileName,
RKADK_U32 u32MuxerId);

成员

相关数据类型及接口

RKADK_MUXER_ATTR_S

3.3.13 RKADK_MUXER_PTS_CALLBACK_FN

说明

定义视频帧时间戳回调函数指针。

定义

typedef RKADK_VOID (*RKADK_MUXER_PTS_CALLBACK_FN)(const RKADK_MUXER_PTS_INFO_S *pstPtsInfo);

成员

相关数据类型及接口

RKADK_MUXER_PTS_INFO_S RKADK_MUXER_ATTR_S

3.3.14 RKADK_MUXER_PTS_INFO_S

说明

定义时间戳信息结构体。

定义

typedef struct {
  RKADK_U32 u32CamId;
  RKADK_S32 s32MuxerId;
  RKADK_U32 u32ChnId;
  RKADK_U64 u64PTS;
  RKADK_U32 u32Seq;
  const char *pFileName;
} RKADK_MUXER_PTS_INFO_S;

成员

相关数据类型及接口

RKADK_MUXER_PTS_CALLBACK_FN

3.3.15 RKADK_MUXER_STREAM_ATTR_S

说明

定义封装码流属性结构体。

定义

typedef struct {
  RKADK_S32 s32MuxerId;
  /* If it is a third-party stream that is not Rockit(such as a network stream),
    * s32ViChn/s32VencChn must set to -1.
  */
  RKADK_S32 s32ViChn;
  RKADK_S32 s32VencChn;
  RKADK_S32 s32ThumbVencChn;
  bool bUseVpss;
  RKADK_U32 u32TimeLenSec; /* record time */
  RKADK_PIP_ATTR_S stPipAttr;
  RKADK_U32 u32GetThumbTime;
  RKADK_U32 u32TrackCnt;   /* track cnt*/
  RKADK_MUXER_TRACK_SOURCE_S
  aHTrackSrcHandle[RKADK_MUXER_TRACK_MAX_CNT]; /* array of track source cnt */
  RKADK_MUXER_FILE_TYPE_E enType;
} RKADK_MUXER_STREAM_ATTR_S;

成员

相关数据类型及接口

RKADK_MUXER_TRACK_SOURCE_S RKADK_MUXER_FILE_TYPE_E

3.3.16 RKADK_MUXER_TRACK_SOURCE_S

说明

定义封装码流属性结构体。

定义

typedef struct {
  RKADK_TRACK_SOURCE_TYPE_E enTrackType;
  union {
    RKADK_TRACK_VIDEO_SOURCE_INFO_S stVideoInfo; /* <video track info */
    RKADK_TRACK_AUDIO_SOURCE_INFO_S stAudioInfo; /* <audio track info */
  } unTrackSourceAttr;
} RKADK_MUXER_TRACK_SOURCE_S;

成员

相关数据类型及接口

RKADK_TRACK_SOURCE_TYPE_E RKADK_TRACK_VIDEO_SOURCE_INFO_S RKADK_TRACK_AUDIO_SOURCE_INFO_S

3.3.17 RKADK_TRACK_SOURCE_TYPE_E

说明

定义封装码流枚举类型。

定义

typedef enum {
  RKADK_TRACK_SOURCE_TYPE_VIDEO = 0,
  RKADK_TRACK_SOURCE_TYPE_AUDIO,
  RKADK_TRACK_SOURCE_TYPE_BUTT
} RKADK_TRACK_SOURCE_TYPE_E;

成员

3.3.18 RKADK_TRACK_VIDEO_SOURCE_INFO_S

说明

定义封装视频流属性结构体。

定义

typedef struct {
  RKADK_CODEC_TYPE_E enCodecType;
  RKADK_CHAR cPixFmt[RKADK_PIX_FMT_LEN];
  RKADK_U32 u32Width;
  RKADK_U32 u32Height;
  RKADK_U32 u32BitRate;
  RKADK_U32 u32FrameRate;
  RKADK_U32 u32Gop;
  RKADK_U16 u16Profile;
  RKADK_U16 u16Level;
  RKADK_U32 u32ThumbWidth;
  RKADK_U32 u32ThumbHeight;
} RKADK_TRACK_VIDEO_SOURCE_INFO_S;

成员

3.3.19 RKADK_TRACK_AUDIO_SOURCE_INFO_S

说明

定义封装音频流属性结构体。

定义

typedef struct {
  RKADK_CODEC_TYPE_E enCodecType;
  RKADK_U16 u32BitWidth;
  RKADK_U32 u32ChnCnt;
  RKADK_U32 u32SampleRate;
  RKADK_U32 u32SamplesPerFrame;
  RKADK_U32 u32Bitrate;
} RKADK_TRACK_AUDIO_SOURCE_INFO_S;

成员

3.3.20 RKADK_MUXER_PRE_RECORD_ATTR_S

说明

定义预录属性结构体。

定义

typedef struct {
  RKADK_U32 u32PreRecTimeSec; /* pre record time, unit in second(s)*/
  RKADK_U32 u32PreRecCacheTime;
  RKADK_MUXER_PRE_RECORD_MODE_E enPreRecordMode;
} RKADK_MUXER_PRE_RECORD_ATTR_S;

成员

相关数据类型及接口

RKADK_MUXER_PRE_RECORD_MODE_E

RKADK_MUXER_ATTR_S

注意

u32PreRecCacheTime必须大于或等于u32PreRecTimeSec,并包含完整的Gop,以便能正确获取I帧。

3.3.21 RKADK_MUXER_PRE_RECORD_MODE_E

说明

定义预录模式枚举类型。

定义

typedef enum {
  RKADK_MUXER_PRE_RECORD_NONE = 0,
  RKADK_MUXER_PRE_RECORD_MANUAL_SPLIT, /* manual split file prerecord */
  RKADK_MUXER_PRE_RECORD_SINGLE        /* first file prerecord */
} RKADK_MUXER_PRE_RECORD_MODE_E;

成员

3.3.22 RKADK_MUXER_DATA_S

说明

定义封装数据结构体。

定义

typedef struct {
  RKADK_S32 s32MuxerId;
  RKADK_S32 s32VencChn;
  int isKeyFrame;
  RKADK_U64 u64Pts;
  RKADK_U32 u32Seq;
  RKADK_U32 u32Len;
  MB_BLK pMbBlk;
} RKADK_MUXER_DATA_S;

成员

相关数据类型及接口

RKADK_MUXER_WriteVideoFrame RKADK_MUXER_WriteAudioFrame

3.3.23 RKADK_MUXER_THUMB_INFO_S

说明

定义缩略图信息结构体。

定义

typedef struct {
  RKADK_S32 s32MuxerId;
  unsigned char* pBuf;
  RKADK_U32 u32Len;
} RKADK_MUXER_THUMB_INFO_S;

成员

相关数据类型及接口

RKADK_MUXER_BuildInThumb

4. AOV(Always On Video)

4.1 概述

AOV(Always On Video)基于休眠唤醒实现的低帧率持续录像,有事件时可以切回正常帧率模式,如AI检测、PIR触 发、WIFI唤醒等。 使用AOV建议开启file cache功能,file cache使用请参考本文档录像章节的RKADK_RECORD_FileCacheInit和 RKADK_RECORD_FileCacheDeInit API。 AOV缩时录影模式下为了降低功耗,休眠后sdcard要掉电,应用休眠前要去卸载sdcard,当使能file cache时,file cache写文件时会去尝试挂载sdcard,并进行写文件保护,确保写文件过程中sdcard不会被卸载。 AOV流程如下图所示:

4.2 API 参考

4.2.1 RKADK_AOV_Init

描述

AOV初始化。

语法

int RKADK_AOV_Init(RKADK_AOV_ARG_S *pstAovAttr);

参数

返回值

需求

头文件:rkadk_aov.h 库文件:librkadk.so

注意

必须和RKADK_AOV_DeInit配套使用。 不支持重复初始化。

举例

rkadk_aov_record_test

相关主题

RKADK_AOV_DeInit

4.2.2 RKADK_AOV_DeInit

描述

AOV反初始化。

语法

int RKADK_AOV_DeInit();

返回值

需求

头文件:rkadk_aov.h 库文件:librkadk.so

注意

必须和RKADK_AOV_Init配套使用。 不支持重复反初始化。

举例

rkadk_aov_record_test

相关主题

RKADK_AOV_Init

4.2.3 RKADK_AOV_SetSuspendTime

描述

设置AOV定时休眠时间 ,单位ms。

语法

int RKADK_AOV_SetSuspendTime(int u32WakeupSuspendTime);

参数

返回值

需求

头文件:rkadk_aov.h 库文件:librkadk.so

举例

rkadk_aov_record_test

4.2.4 RKADK_AOV_EnterSleep

描述

进入AOV。

语法

int RKADK_AOV_EnterSleep();

返回值

需求

头文件:rkadk_aov.h 库文件:librkadk.so

举例

rkadk_aov_record_test

4.2.5 RKADK_AOV_WakeupLock

描述

AOV相关操作加锁。

语法

void RKADK_AOV_WakeupLock();

需求

头文件:rkadk_aov.h 库文件:librkadk.so

注意

必须和RKADK_AOV_WakeupUnlock配套使用。

举例

rkadk_aov_record_test

相关主题

RKADK_AOV_WakeupUnlock

4.2.6 RKADK_AOV_WakeupUnlock

描述

AOV相关操作解锁。

语法

void RKADK_AOV_WakeupUnlock();

需求

头文件:rkadk_aov.h 库文件:librkadk.so

注意

必须和RKADK_AOV_WakeupLock配套使用。

举例

rkadk_aov_record_test

相关主题

RKADK_AOV_WakeupLock

4.3 数据类型

AOV模块主要提供以下数据类型: RKADK_AOV_ARG_S:AOV属性结构体 RKADK_AOV_NOTIFY_CALLBACK:AOV通知回调函数指针

4.3.1 RKADK_AOV_ARG_S

说明

定义AOV属性结构体。

定义

typedef struct {
  RKADK_AOV_NOTIFY_CALLBACK pfnNotifyCallback;
} RKADK_AOV_ARG_S;

成员

相关数据类型及接口

RKADK_AOV_Init RKADK_AOV_NOTIFY_CALLBACK

4.3.2 RKADK_AOV_NOTIFY_CALLBACK

说明

定义AOV通知回调函数指针。

定义

typedef void (*RKADK_AOV_NOTIFY_CALLBACK)(RKADK_AOV_EVENT_E enEvent, void *msg);

成员

相关数据类型及接口

RKADK_AOV_ARG_S RKADK_AOV_EVENT_E

4.3.3 RKADK_AOV_EVENT_E

说明

定义AOV通知事件枚举。

定义

typedef enum {
  RKADK_AOV_ENTER_SLEEP = 0,
  RKADK_AOV_EVENT_BUTT
} RKADK_AOV_EVENT_E;

成员

相关数据类型及接口

RKADK_AOV_NOTIFY_CALLBACK

5. 拍照

5.1 概述

提供基本的抓拍功能,提供JPEG封装拍照,包含如下功能: 单拍 多拍 JPEG Slice:将VI数据分段编码生成JPEG,可以节省内存用量。当JPEG放大时,使用插值算法,将VI数据分段 放大,再分段编码成JPEG。 JPEG Slice 注意事项: 分段高要求16像素对⻬。 考虑最终图像的拼接效果,建议分段后的图片比例与原始图片比例尽量保持一致。 分段数越多,所需内存越少,但出图耗时增加。反之当分段数减少时,所需内存增加,但出图速度加快;实际 分段数需结合实际情况考量。

5.2 API 参考

5.2.1 RKADK_PHOTO_Init

描述

拍照任务初始化。

语法

RKADK_S32 RKADK_PHOTO_Init(RKADK_PHOTO_ATTR_S *pstPhotoAttr, RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

注意

不支持重复初始化。

举例

rkadk_photo_test

相关主题

RKADK_PHOTO_DeInit

5.2.2 RKADK_PHOTO_DeInit

描述

拍照任务反初始化。

语法

RKADK_S32 RKADK_PHOTO_DeInit(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

注意

不支持重复反初始化。

举例

rkadk_photo_test

相关主题

RKADK_PHOTO_DeInit

5.2.3 RKADK_PHOTO_TakePhoto

描述

拍照。

语法

RKADK_S32 RKADK_PHOTO_TakePhoto(RKADK_MW_PTR pHandle, RKADK_TAKE_PHOTO_ATTR_S *pstAttr);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

注意

录像任务初始化后,才能使用RKADK_PHOTO_TakePhoto接口。

举例

rkadk_photo_test

相关主题

无

5.2.4 RKADK_PHOTO_Reset

描述

重新配置拍照任务 。

语法

RKADK_S32 RKADK_PHOTO_Reset(RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

注意

录像任务初始化后,才能使用RKADK_PHOTO_Reset接口。 切换分辨率时,结合RKADK_PARAM_SetCamParam API重置ini文件中Photo模块的分辨率。 RV1126/RV1109、RK3576不支持动态切换分辨率,需要先RKADK_PHOTO_DeInit,然后配置新的分辨率,再 重新RKADK_PHOTO_Init。 如果Photo和其他模块复用VI通道,需要同时切换Photo和复用模块的分辨率,否则会导致VI和VENC分辨率不 匹配。

举例

rkadk_photo_test

相关主题

5.2.5 RKADK_PHOTO_GetThmInJpg

描述

从JPG文件中获取缩略图数据。

语法

RKADK_S32 RKADK_PHOTO_GetThmInJpg(RKADK_U32 u32CamId, RKADK_CHAR *pszFileName, RKADK_JPG_THUMB_TYPE_E eThmType, RKADK_U8 *pu8Buf, RKADK_U32 *pu32Size);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

举例

rkadk_thumb_test

相关主题

无

5.2.6 RKADK_PHOTO_GetThmInJpgEx

描述

JPG获取缩略图扩展接口,从JPG文件中获取缩略图数据,支持指定输出缩略图的类型和分辨率。必须和 RKADK_PHOTO_ThumbBufFree配套使用。

语法

RKADK_S32 RKADK_PHOTO_GetThmInJpgEx(RKADK_U32 u32CamId, RKADK_CHAR *pszFileName, RKADK_JPG_THUMB_TYPE_E eThmType, RKADK_THUMB_ATTR_S *pstThumbAttr);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

举例

rkadk_thumb_test

相关主题

RKADK_PHOTO_ThumbBufFree

5.2.7 RKADK_PHOTO_ThumbBufFree

描述

释放RKADK_PHOTO_GetThmInJpgEx申请的内存。必须和RKADK_PHOTO_GetThmInJpgEx配套使用。

语法

RKADK_S32 RKADK_PHOTO_ThumbBufFree(RKADK_THUMB_ATTR_S *pstThumbAttr);

参数

返回值

需求

头文件:rkadk_photo.h 库文件:librkadk.so

举例

rkadk_thumb_test

相关主题

RKADK_PHOTO_GetThmInJpgEx

5.2.8 RKADK_MEDIA_SetVencRotation

描述

设置VENC通道旋转。

语法

RKADK_S32 RKADK_MEDIA_SetVencRotation(RKADK_U32 u32CamId, ROTATION_E enRotation, RKADK_STREAM_TYPE_E enStreamType);

参数

返回值

需求

头文件:rkadk_media_comm.h 库文件:librkadk.so

5.2.9 RKADK_MEDIA_ToggleVencMirror

描述

设置VENC通道Mirror。

语法

RKADK_S32 RKADK_MEDIA_ToggleVencMirror(RKADK_U32 u32CamId, RKADK_STREAM_TYPE_E enStrmType, bool mirror);

参数

返回值

需求

头文件:rkadk_media_comm.h 库文件:librkadk.so

5.2.10 RKADK_MEDIA_ToggleVencFlip

描述

设置VENC通道Flip。

语法

RKADK_S32 RKADK_MEDIA_ToggleVencFlip(RKADK_U32 u32CamId, RKADK_STREAM_TYPE_E enStrmType, bool flip);

参数

返回值

需求

头文件:rkadk_media_comm.h 库文件:librkadk.so

5.3 数据类型

拍照模块主要提供以下数据类型: RKADK_PHOTO_TYPE_E:拍照类型枚举 RKADK_PHOTO_SINGLE_ATTR_S:单拍属性结构体 RKADK_PHOTO_MULTIPLE_ATTR_S:多拍属性结构体 RKADK_PHOTO_RECV_DATA_S:拍照数据结构体 RKADK_PHOTO_DATA_RECV_FN_PTR:拍照数据接收函数指针 RKADK_TAKE_PHOTO_ATTR_S:拍照属性结构体 RKADK_PHOTO_ATTR_S:拍照任务属性结构体 RKADK_JPG_THUMB_TYPE_E:JPG缩略图类型枚举 RKADK_THUMB_TYPE_E:输出缩略图类型枚举 RKADK_THUMB_ATTR_S:缩略图属性结构体 ROTATION_E:旋转类型枚举 RKADK_PHOTO_FMT_CHANGE_S:格式转换参数结构体,用于FBC0/NV16格式转换

5.3.1 RKADK_PHOTO_TYPE_E

说明

定义拍照类型枚举。

定义

typedef enum {
  RKADK_PHOTO_TYPE_SINGLE = 0,
  RKADK_PHOTO_TYPE_MULTIPLE,
  RKADK_PHOTO_TYPE_LAPSE, // TODO
  RKADK_PHOTO_TYPE_BUTT
} RKADK_PHOTO_TYPE_E;

成员

相关数据类型及接口

RKADK_TAKE_PHOTO_ATTR_S

5.3.2 RKADK_PHOTO_SINGLE_ATTR_S

说明

定义单拍属性结构体。

定义

typedef struct {
  // TODO
  RKADK_S32 s32Time_sec;
} RKADK_PHOTO_SINGLE_ATTR_S;

成员

相关数据类型及接口

RKADK_TAKE_PHOTO_ATTR_S

5.3.3 RKADK_PHOTO_MULTIPLE_ATTR_S

说明

定义多拍属性结构体。

定义

typedef struct {
  /* s32Count is -1 that means continuous photo, larger than 0 that meas photo
   * number */
  RKADK_S32 s32Count;
} RKADK_PHOTO_MULTIPLE_ATTR_S;

成员

相关数据类型及接口

RKADK_TAKE_PHOTO_ATTR_SS

5.3.4 RKADK_PHOTO_THUMB_ATTR_S

说明

定义缩略图参数属性结构体。

定义

#define RKADK_MPF_LARGE_THUMB_NUM_MAX 2  /* ⽀持同时⽣成的最⼤MPF缩略图个数 */

typedef struct rkSIZE_S {
  RK_U32 u32Width;               /* 缩略图宽 */
  RK_U32 u32Height;              /* 缩略图⾼ */
} SIZE_S;

typedef enum {
  RKADK_PHOTO_MPF_SINGLE = 0,    /* 单个MPF缩略图 */
  RKADK_PHOTO_MPF_MULTI,         /* 多个MPF缩略图 */
  RKADK_PHOTO_MPF_BUTT
} RKADK_PHOTO_MPF_MODE_E;

typedef struct {
  RKADK_U8 u8LargeThumbNum;      /* ⽣成的MPF缩略图个数 */
  SIZE_S astLargeThumbSize[RKADK_MPF_LARGE_THUMB_NUM_MAX];  /* 各缩略图分辨率 */
} RKADK_PHOTO_MPF_CFG_S;

typedef struct {
  RKADK_PHOTO_MPF_MODE_E eMode;  /* MPF缩略图模式 */
  RKADK_PHOTO_MPF_CFG_S sCfg;    /* MPF缩略图配置 */
} RKADK_PHOTO_MPF_ATTR_S;

typedef struct {
  RKADK_BOOL bSupportDCF; /* Fixed resolution: 160 * 120 jpg */
  RKADK_PHOTO_MPF_ATTR_S stMPFAttr;
} RKADK_PHOTO_THUMB_ATTR_S;

成员

相关数据类型及接口

RKADK_PHOTO_ATTR_S

5.3.5 RKADK_PHOTO_RECV_DATA_S

说明

定义拍照数据结构体。

定义

typedef struct {
  RKADK_U8 *pu8DataBuf;
  RKADK_U32 u32DataLen;
  RKADK_U32 u32CamId;
  bool bStreamEnd;
  void *userdata;
} RKADK_PHOTO_RECV_DATA_S;

成员

相关数据类型及接口

RKADK_PHOTO_DATA_RECV_FN_PTR

5.3.6 RKADK_PHOTO_DATA_RECV_FN_PTR

说明

定义拍照数据接收函数指针。

定义

typedef void (*RKADK_PHOTO_DATA_RECV_FN_PTR)(RKADK_PHOTO_RECV_DATA_S *pstData);

成员

相关数据类型及接口

RKADK_PHOTO_RECV_DATA_S RKADK_PHOTO_ATTR_S

5.3.7 RKADK_TAKE_PHOTO_ATTR_S

说明

定义拍照属性结构体。

定义

typedef struct {
  RKADK_PHOTO_TYPE_E enPhotoType;
  union tagPhotoTypeAttr {
    RKADK_PHOTO_SINGLE_ATTR_S stSingleAttr;
    RKADK_PHOTO_LAPSE_ATTR_S stLapseAttr; // TODO
    RKADK_PHOTO_MULTIPLE_ATTR_S stMultipleAttr;
  } unPhotoTypeAttr;
} RKADK_TAKE_PHOTO_ATTR_S;

成员

相关数据类型及接口

RKADK_PHOTO_TYPE_E RKADK_PHOTO_SINGLE_ATTR_S RKADK_PHOTO_MULTIPLE_ATTR_S RKADK_PHOTO_TakePhoto

5.3.8 RKADK_PHOTO_FMT_CHANGE_S

说明

定义格式转换参数结构体,用于FBC0/NV16格式转换

定义

typedef struct {
  RKADK_U32 u32VencChn;
  RKADK_U32 u32VdecChn;

  //format change venc parameter
  RKADK_U32 u32BitRate;   //default 4M
  RKADK_U32 u32Profile;   //default 77
} RKADK_PHOTO_FMT_CHANGE_S;

成员

相关数据类型及接口

RKADK_PHOTO_ATTR_S RKADK_PHOTO_Init

5.3.9 RKADK_PHOTO_ATTR_S

说明

定义拍照任务属性结构体。

定义

typedef struct {
  RKADK_U32 u32CamId;
  RKADK_PHOTO_THUMB_ATTR_S stThumbAttr;
  RKADK_PHOTO_DATA_RECV_FN_PTR pfnPhotoDataProc;
  void *userdata;
  RKADK_POST_ISP_ATTR_S *pstPostIspAttr;
  RKADK_PHOTO_FMT_CHANGE_S stFmtChange;
} RKADK_PHOTO_ATTR_S;

成员

相关数据类型及接口

RKADK_PHOTO_THUMB_ATTR_S RKADK_PHOTO_DATA_RECV_FN_PTR RKADK_POST_ISP_ATTR_S RKADK_PHOTO_FMT_CHANGE_S RKADK_PHOTO_Init

5.3.10 RKADK_JPG_THUMB_TYPE_E

说明

定义JPG缩略图类型枚举。

定义

typedef enum {
  RKADK_JPG_THUMB_TYPE_DCF,
  RKADK_JPG_THUMB_TYPE_MFP1,
  RKADK_JPG_THUMB_TYPE_MFP2,
  RKADK_JPG_THUMB_TYPE_BUTT
} RKADK_JPG_THUMB_TYPE_E;

成员

相关数据类型及接口

RKADK_PHOTO_GetThmInJpg RKADK_PHOTO_GetThmInJpgEx

5.3.11 RKADK_THUMB_TYPE_E

说明

定义输出缩略图类型枚举。

定义

typedef enum {
  RKADK_THUMB_TYPE_NV12 = 0,
  RKADK_THUMB_TYPE_JPEG,
  RKADK_THUMB_TYPE_RGB565,
  RKADK_THUMB_TYPE_RGBA8888,
  RKADK_THUMB_TYPE_BGRA8888
} RKADK_THUMB_TYPE_E;

成员

相关数据类型及接口

RKADK_THUMB_ATTR_S RKADK_GetThmInMp4Ex RKADK_PHOTO_GetThmInJpgEx

5.3.12 RKADK_THUMB_ATTR_S

说明

定义缩略图属性结构体。

定义

typedef struct {
  RKADK_THUMB_TYPE_E enType;
  // 4 alignment
  RKADK_U32 u32Width;
  // 2 alignment
  RKADK_U32 u32Height;
  // 4 alignment
  RKADK_U32 u32VirWidth;
  // 2 alignment
  RKADK_U32 u32VirHeight;
  RKADK_U8 *pu8Buf;
  RKADK_U32 u32BufSize;
} RKADK_THUMB_ATTR_S;

成员

相关数据类型及接口

RKADK_THUMB_TYPE_E RKADK_GetThmInMp4Ex

RKADK_PHOTO_GetThmInJpgEx

5.3.13 ROTATION_E

说明

定义旋转类型枚举。

定义

typedef enum rkROTATION_E {
    ROTATION_0        = 0,
    ROTATION_90       = 1,
    ROTATION_180      = 2,
    ROTATION_270      = 3,
    ROTATION_BUTT
} ROTATION_E;

相关数据类型及接口

RKADK_MEDIA_SetVencRotation

6. 远程预览

6.1 概述

为预览提供获取Video和Audio信息,启停VENC,启停AENC,注册处理音视频帧数据函数的回调接口。

6.2 API参考

6.2.1 RKADK_STREAM_VideoInit

描述

初始化Video模块:VI、VENC。

语法

RKADK_S32 RKADK_STREAM_VideoInit(RKADK_STREAM_VIDEO_ATTR_S *pstVideoAttr, RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

不支持重复初始化Video模块。

举例

rkadk_stream_test

相关主题

RKADK_STREAM_VideoDeInit

6.2.2 RKADK_STREAM_VideoDeInit

描述

反初始化Video模块:VI、VENC。

语法

RKADK_S32 RKADK_STREAM_VideoDeInit(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

不支持重复反初始化。

举例

rkadk_stream_test

相关主题

RKADK_STREAM_VideoInit

6.2.3 RKADK_STREAM_VencStart

描述

启动VENC。

语法

RKADK_S32 RKADK_STREAM_VencStart(RKADK_MW_PTR pHandle, RKADK_S32 s32FrameCnt);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

初始化Video模块后,才能调用RKADK_STREAM_VencStart接口。 调用RKADK_STREAM_VencStart后,触发VENC数据回调函数开始接收数据。

举例

rkadk_stream_test

相关主题

RKADK_STREAM_VencStop

6.2.4 RKADK_STREAM_VencStop

描述

停止VENC。

语法

RKADK_S32 RKADK_STREAM_VencStop(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

无

举例

rkadk_stream_test

相关主题

RKADK_STREAM_VencStart

6.2.5 RKADK_STREAM_VideoReset

描述

重新配置Video。

语法

RKADK_S32 RKADK_STREAM_VideoReset(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

Video初始化后,才能使用RKADK_STREAM_VideoReset接口。 切换分辨率、帧率、比特率、编码类型、录像类型时,结合RKADK_PARAM_SetCamParam API重置ini文件中 Preview模块的参数 RV1126/RV1109、RK3576不支持动态切换分辨率和编码类型,需要先RKADK_STREAM_VideoDeInit,然后配 置新的分辨率,再重新RKADK_STREAM_VideoInit。 如果Stream Video和其他模块复用VI通道,需要同时切换Video和其他模块的分辨率,否则会导致VI和VENC分 辨率不匹配。

举例

rkadk_stream_test

6.2.6 RKADK_STREAM_GetVideoInfo

描述

获取Video信息。

语法

RKADK_S32 RKADK_STREAM_GetVideoInfo(RKADK_U32 u32CamId, RKADK_VIDEO_INFO_S *pstVideoInfo);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

无

举例

rkadk_stream_test

相关主题

无

6.2.7 RKADK_STREAM_AudioInit

描述

初始化Audio模块:AI、AENC。

语法

RKADK_S32 RKADK_STREAM_AudioInit(RKADK_STREAM_AUDIO_ATTR_S *pstAudioAttr, RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

不支持重复初始化Audio模块。

举例

rkadk_stream_test

相关主题

RKADK_STREAM_AudioDeInit

6.2.8 RKADK_STREAM_AudioDeInit

描述

反初始化Audio模块:AI、AENC。

语法

RKADK_S32 RKADK_STREAM_AudioDeInit(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

无

举例

rkadk_stream_test

相关主题

RKADK_STREAM_AudioInit

6.2.9 RKADK_STREAM_AencStart

描述

启动AENC。

语法

RKADK_S32 RKADK_STREAM_AencStart(RKADK_MW_PTR *pHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

初始化Audio模块后,才能调用RKADK_STREAM_AencStart接口。 调用RKADK_STREAM_AencStart后,触发AENC数据回调函数开始接收数据。

举例

rkadk_stream_test

相关主题

RKADK_STREAM_AencStop

6.2.10 RKADK_STREAM_AencStop

描述

停止AENC。

语法

RKADK_S32 RKADK_STREAM_AencStop(RKADK_MW_PTR *pHandle);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

无

举例

rkadk_stream_test

相关主题

RKADK_STREAM_AencStart

6.2.11 RKADK_STREAM_GetAudioInfo

描述

获取Audio信息。

语法

RKADK_S32 RKADK_STREAM_GetAudioInfo(RKADK_MW_PTR *pHandle, RKADK_AUDIO_INFO_S *pstAudioInfo);

参数

返回值

需求

头文件:rkadk_stream.h 库文件:librkadk.so

注意

无

举例

rkadk_stream_test

相关主题

无

6.3 数据类型

播放模块主要提供以下数据类型: RKADK_CODEC_TYPE_E:编码格式枚举 RKADK_VENC_DATA_PROC_FUNC:VENC数据回调函数指针 RKADK_VIDEO_STREAM_S:Video数据流结构体 RKADK_VENC_DATA_PACK_S:VENC数据包结构体 RKADK_VENC_DATA_TYPE_S:VENC数据包类型 RKADK_VIDEO_INFO_S:Video信息结构体 RKADK_STREAM_VIDEO_ATTR_S:Video任务属性结构体 RKADK_AUDIO_DATA_PROC_FUNC:Audio数据回调函数指针 RKADK_AUDIO_STREAM_S:Audio数据结构体 RKADK_AUDIO_INFO_S:Audio信息结构体 RKADK_STREAM_AUDIO_ATTR_S:Audio任务属性结构体

6.3.1 RKADK_CODEC_TYPE_E

说明

定义编码格式枚举类型 ,Audio编码默认不支持AAC。

定义

typedef enum {
  //Video
  RKADK_CODEC_TYPE_H264 = 0,
  RKADK_CODEC_TYPE_H265,
  RKADK_CODEC_TYPE_MJPEG,
  RKADK_CODEC_TYPE_JPEG,

  //Audio
  RKADK_CODEC_TYPE_G711A,
  RKADK_CODEC_TYPE_G711U,
  RKADK_CODEC_TYPE_G726,
  RKADK_CODEC_TYPE_MP2,
  RKADK_CODEC_TYPE_MP3,
  RKADK_CODEC_TYPE_ACC,
  RKADK_CODEC_TYPE_PCM,
  RKADK_CODEC_TYPE_BUTT
} RKADK_CODEC_TYPE_E;

6.3.2 RKADK_VENC_DATA_PROC_FUNC

说明

定义VENC数据回调函数指针。

定义

typedef RKADK_S32 (*RKADK_VENC_DATA_PROC_FUNC)(RKADK_VIDEO_STREAM_S *pVStreamData);

相关数据类型及接口

RKADK_VIDEO_STREAM_S

6.3.3 RKADK_VIDEO_STREAM_S

说明

定义Video 数据流结构体。

定义

typedef struct {
  RKADK_VENC_DATA_PACK_S astPack; /* stream pack attribute */
  RKADK_U32 u32Seq;               /* the list number of stream */
  RKADK_BOOL bEndOfStream;        /* frame end flag */
  RKADK_U32 u32CamId;
} RKADK_VIDEO_STREAM_S;

成员

相关数据类型及接口

RKADK_VENC_DATA_PACK_S RKADK_VENC_DATA_PROC_FUNC

6.3.4 RKADK_VENC_DATA_PACK_S

说明

定义VENC数据包结构体。

定义

typedef struct {
  RKADK_U8 *apu8Addr;                /* the virtual address of stream */
  RKADK_U32 au32Len;                 /* the length of stream */
  RKADK_U64 u64PTS;                  /* time stamp */
  RKADK_VENC_DATA_TYPE_S stDataType; /* the type of stream */
} RKADK_VENC_DATA_PACK_S;

成员

相关数据类型及接口

RKADK_VENC_DATA_TYPE_S RKADK_VIDEO_STREAM_S

6.3.5 RKADK_VENC_DATA_TYPE_S

说明

定义VENC数据包类型。

定义

/* the nalu type of H264 */
typedef enum {
  RKADK_H264E_NALU_BSLICE = 0,   /* B SLICE types */
  RKADK_H264E_NALU_PSLICE = 1,   /* P SLICE types */
  RKADK_H264E_NALU_ISLICE = 2,   /* I SLICE types */
  RKADK_H264E_NALU_IDRSLICE = 5, /* IDR SLICE types */
  RKADK_H264E_NALU_SEI = 6,      /* SEI types */
  RKADK_H264E_NALU_SPS = 7,      /* SPS types */
  RKADK_H264E_NALU_PPS = 8,      /* PPS types */
  RKADK_H264E_NALU_BUTT
} RKADK_H264E_NALU_TYPE_E;
/* the nalu type of H265 */
typedef enum {
  RKADK_H265E_NALU_BSLICE = 0,    /* B SLICE types */
  RKADK_H265E_NALU_PSLICE = 1,    /* P SLICE types */
  RKADK_H265E_NALU_ISLICE = 2,    /* I SLICE types */
  RKADK_H265E_NALU_IDRSLICE = 19, /* IDR SLICE types */
  RKADK_H265E_NALU_VPS = 32,      /* VPS types */
  RKADK_H265E_NALU_SPS = 33,      /* SPS types */
  RKADK_H265E_NALU_PPS = 34,      /* PPS types */
  RKADK_H265E_NALU_SEI = 39,      /* SEI types */
  RKADK_H265E_NALU_BUTT
} RKADK_H265E_NALU_TYPE_E;

typedef struct {
  RKADK_CODEC_TYPE_E enPayloadType;      /* H.264/H.265/JPEG/MJPEG */
  union {
    RKADK_H264E_NALU_TYPE_E enH264EType; /* H264E NALU types */
    RKADK_H265E_NALU_TYPE_E enH265EType; /* H265E NALU types */
    RKADK_JPEGE_PACK_TYPE_E enJPEGEType; /* TODO: JPEGE PACK types*/
  };
} RKADK_VENC_DATA_TYPE_S;

成员

相关数据类型及接口

RKADK_CODEC_TYPE_E RKADK_VENC_DATA_PACK_S

6.3.6 RKADK_VIDEO_INFO_S

说明

定义Video信息结构体。

定义

typedef struct {
  RKADK_CODEC_TYPE_E enCodecType;
  RKADK_U32 u32Width;
  RKADK_U32 u32Height;
  RKADK_U32 u32BitRate;
  RKADK_U32 u32FrameRate;
  RKADK_U32 u32Gop;
} RKADK_VIDEO_INFO_S;

成员

相关数据类型及接口

RKADK_CODEC_TYPE_E RKADK_STREAM_GetVideoInfo

6.3.7 RKADK_STREAM_VIDEO_ATTR_S

说明

定义Video任务属性结构体。

定义

typedef struct {
  RKADK_U32 u32CamId;
  RKADK_VENC_DATA_PROC_FUNC pfnDataCB;
} RKADK_STREAM_VIDEO_ATTR_S;

成员

相关数据类型及接口

RKADK_VENC_DATA_PROC_FUNC RKADK_STREAM_VideoInit

6.3.8 RKADK_AUDIO_DATA_PROC_FUNC

说明

定义AENC数据回调函数指针。

定义

typedef RKADK_S32 (*RKADK_AUDIO_DATA_PROC_FUNC)(RKADK_AUDIO_STREAM_S *pAStreamData);

相关数据类型及接口

RKADK_AUDIO_STREAM_S

6.3.9 RKADK_AUDIO_STREAM_S

说明

定义Audio数据流结构体。

定义

typedef struct {
  RKADK_U8 *pStream;      /* the virtual address of stream */
  RKADK_U32 u32Len;       /* stream lenth, by bytes */
  RKADK_U64 u64TimeStamp; /* frame time stamp */
  RKADK_U32 u32Seq;       /* frame seq, if stream is not a valid frame,u32Seq is 0 */
  RKADK_CODEC_TYPE_E enType;
} RKADK_AUDIO_STREAM_S;

成员

相关数据类型及接口

RKADK_AUDIO_DATA_PROC_FUNC

6.3.10 RKADK_AUDIO_INFO_S

说明

定义Audio信息结构体。

定义

typedef struct {
  RKADK_CODEC_TYPE_E enCodecType;
  RKADK_U32 u32ChnCnt;
  RKADK_U32 u32SampleRate;
  RKADK_U32 u32AvgBytesPerSec;
  RKADK_U32 u32SamplesPerFrame;
  RKADK_U16 u16SampleBitWidth;
} RKADK_AUDIO_INFO_S;

成员

相关数据类型及接口

RKADK_CODEC_TYPE_E RKADK_STREAM_GetAudioInfo

6.3.11 RKADK_STREAM_AUDIO_ATTR_S

说明

定义Audio任务属性结构体。

定义

typedef struct {
  RKADK_U32 u32CamId;
  RKADK_CODEC_TYPE_E enCodecType;
  RKADK_AUDIO_DATA_PROC_FUNC pfnPcmDataCB;
  RKADK_AUDIO_DATA_PROC_FUNC pfnAencDataCB;
} RKADK_STREAM_AUDIO_ATTR_S;

成员

相关数据类型及接口

RKADK_AUDIO_DATA_PROC_FUNC RKADK_STREAM_AudioInit

7. 播放器

7.1 概述

提供本地音视频文件、RTSP网络流播放功能,支持基本的播控操作:播放、暂停、 Seek、屏幕快照 。 Player功能兼容RV1109/RV1126、RV1103/RV1103、RK3308、RK3506平台,其中RV1109/RV1126使用硬件解码, 其他平台使用软件解码。

7.2 API 参考

7.2.1 RKADK_PLAYER_Create

描述

创建播放器。

语法

RKADK_S32 RKADK_PLAYER_Create(RKADK_MW_PTR *ppPlayer, RKADK_PLAYER_CFG_S *pstPlayCfg);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

不支持重复创建同一播放器。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_Destroy

7.2.2 RKADK_PLAYER_Destroy

描述

销毁播放器。

语法

RKADK_S32 RKADK_PLAYER_Destroy(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

不支持重复销毁同一播放器。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_Create

7.2.3 RKADK_PLAYER_SetDataSource

描述

设置待播放文件路径,Player使能第三方demuxer库时,需使用RKADK_PLAYER_SetDataParam。

语法

RKADK_S32 RKADK_PLAYER_SetDataSource(RKADK_MW_PTR pPlayer, const RKADK_CHAR *pszfilePath);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

创建播放器后,才能调用RKADK_PLAYER_SetDataSource接口。

举例

rkadk_player_test

相关主题

无

7.2.4 RKADK_PLAYER_SetDataParam

描述

设置待播放文件的音视频参数,Player使能第三方demuxer库时,使用该接口,否则使用 RKADK_PLAYER_SetDataSource。

语法

RKADK_S32 RKADK_PLAYER_SetDataParam(RKADK_MW_PTR pPlayer, RKADK_PLAYER_DATA_PARAM_S *pstDataParam);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

创建播放器后,才能调用RKADK_PLAYER_SetDataParam接口。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_SendAudioPacket RKADK_PLAYER_SendVideoPacket

7.2.5 RKADK_PLAYER_Prepare

描述

播放准备。

语法

RKADK_S32 RKADK_PLAYER_Prepare(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h

库文件:librkadk.so

注意

创建播放器和设置播放路径后,才能调用RKADK_PLAYER_Prepare接口。

举例

rkadk_player_test

相关主题

无

7.2.6 RKADK_PLAYER_GetCurrentPosition

描述

获取当前播放进度。

语法

RKADK_S64 RKADK_PLAYER_GetCurrentPosition(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

无

举例

rkadk_player_test

相关主题

无

7.2.7 RKADK_PLAYER_Play

描述

开始播放。

语法

RKADK_S32 RKADK_PLAYER_Play(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

调用RKADK_PLAYER_Prepare 后,才能调用RKADK_PLAYER_Play接口。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_Stop

7.2.8 RKADK_PLAYER_Stop

描述

停止播放,并释放资源。

语法

RKADK_S32 RKADK_PLAYER_Stop(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

无

举例

rkadk_player_test

相关主题

RKADK_PLAYER_Play

7.2.9 RKADK_PLAYER_Pause

描述

暂停播放。

语法

RKADK_S32 RKADK_PLAYER_Pause(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

无

举例

rkadk_player_test

相关主题

RKADK_PLAYER_Play

7.2.10 RKADK_PLAYER_Seek

描述

Seek。

语法

RKADK_S32 RKADK_PLAYER_Seek(RKADK_MW_PTR pPlayer, RKADK_S64 s64TimeInMs);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

调用RKADK_PLAYER_Play后,才能调用RKADK_PLAYER_Seek接口。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_Play

7.2.11 RKADK_PLAYER_GetPlayStatus

描述

获取当前播放状态。

语法

RKADK_S32 RKADK_PLAYER_GetPlayStatus(RKADK_MW_PTR pPlayer, RKADK_PLAYER_STATE_E *penState);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

无

举例

rkadk_player_test

相关主题

无

7.2.12 RKADK_PLAYER_GetDuration

描述

获取当前播放文件时⻓。

语法

RKADK_S32 RKADK_PLAYER_GetDuration(RKADK_MW_PTR pPlayer, RKADK_U32 *pDuration);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

无

举例

rkadk_player_test

相关主题

无

7.2.13 RKADK_PLAYER_Snapshot

描述

Player屏幕快照,调用该接口,会将当前显示的画面,编码成JPEG数据,应用可通过注册 RKADK_PPLAYER_SNAPSHOT_RECV_FN回调获取生成的JPEG数据。

语法

RKADK_S32 RKADK_PLAYER_Snapshot(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

举例

rkadk_player_test

相关主题

无

7.2.14 RKADK_PLAYER_SendAudioPacket

描述

Player使能第三方demuxer库时,使用该接口发送解封装后的音频数据给Player解码播放。

语法

RKADK_S32 RKADK_PLAYER_SendAudioPacket(RKADK_MW_PTR pPlayer, RKADK_PLAYER_PACKET *pstPacket);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

使用该接口前,需要先调用RKADK_PLAYER_SetDataParam设置音视频相关参数。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_SendVideoPacket RKADK_PLAYER_SetDataParam

7.2.15 RKADK_PLAYER_SendVideoPacket

描述

Player使能第三方demuxer库时,使用该接口发送解封装后的视频数据给Player解码播放。

语法

RKADK_S32 RKADK_PLAYER_SendVideoPacket(RKADK_MW_PTR pPlayer, RKADK_PLAYER_PACKET *pstPacket);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

使用该接口前,需要先调用RKADK_PLAYER_SetDataParam设置音视频相关参数。

举例

rkadk_player_test

相关主题

RKADK_PLAYER_SendAudioPacket RKADK_PLAYER_SetDataParam

7.2.16 RKADK_PLAYER_GetSendFrameNum

描述

获取当前解码成功的帧数。

语法

RKADK_S32 RKADK_PLAYER_GetSendFrameNum(RKADK_MW_PTR pPlayer);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

Pause/Stop后将重新计数。

举例

rkadk_player_test

相关主题

无

7.2.17 RKADK_PLAYER_SetVdecWaterline

描述

设置VDEC水线。

语法

RKADK_S32 RKADK_PLAYER_SetVdecWaterline(RKADK_MW_PTR pPlayer, RKADK_U32 u32VdecWaterline);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

设置VDEC水线后,只有当VDEC缓存buffer到达水线值才会开始播放

举例

rkadk_player_test

相关主题

无

7.2.18 RKADK_PLAYER_SetAoVolume

描述

设置播放音量。

语法

RKADK_S32 RKADK_PLAYER_SetAoVolume(RKADK_MW_PTR pPlayer, RKADK_S32 s32Volume);

参数

返回值

需求

头文件:rkadk_player.h 库文件:librkadk.so

注意

无

举例

rkadk_player_test

相关主题

无

7.3 数据类型

播放模块主要提供以下数据类型: RKADK_PLAYER_EVENT_E:播放事件枚举类型 RKADK_PLAYER_EVENT_FN:播放事件回调函数指针 RKADK_PLAYER_CFG_S:播放器属性结构体 RKADK_VO_FORMAT_E:图像像素格式枚举类型 RKADK_VO_INTF_TYPE_E:显示接口枚举类型 RKADK_PLAYER_FRAME_INFO_S:图像信息结构体 RKADK_PLAYER_STATE_E:播放状态枚举类型 RKADK_PLAYER_DATA_PARAM_S:音视频参数结构体 RKADK_PLAYER_PACKET:播放器数据包结构体 RKADK_PLAYER_RTSP_CFG_S:Rtsp属性结构体 RKADK_PLAYER_VDEC_CFG_S:VDEC属性结构体 RKADK_PLAYER_SNAPSHOT_CFG_S:屏幕快照属性结构体 RKADK_PLAYER_SNAPSHOT_S:屏幕快照数据结构体 RKADK_PPLAYER_SNAPSHOT_RECV_FN:屏幕快照数据回调函数指针

7.3.1 RKADK_PLAYER_EVENT_E

说明

定义播放事件枚举类型。

定义

typedef enum {
  RKADK_PLAYER_EVENT_STATE_CHANGED = 0x0,
  RKADK_PLAYER_EVENT_PREPARED,
  RKADK_PLAYER_EVENT_PLAY,
  RKADK_PLAYER_EVENT_PAUSED,
  RKADK_PLAYER_EVENT_STOPPED,
  RKADK_PLAYER_EVENT_EOF,
  RKADK_PLAYER_EVENT_SOF,
  RKADK_PLAYER_EVENT_SEEK_END,
  RKADK_PLAYER_EVENT_ERROR,
  RKADK_PLAYER_EVENT_BUTT
} RKADK_PLAYER_EVENT_E;

成员

相关数据类型及接口

RKADK_PLAYER_EVENT_FN

7.3.2 RKADK_PLAYER_EVENT_FN

说明

定义播放事件回调函数指针。

定义

typedef RKADK_VOID (*RKADK_PLAYER_EVENT_FN)(RKADK_MW_PTR pPlayer, RKADK_PLAYER_EVENT_E
enEvent, RKADK_VOID *pData);

成员

相关数据类型及接口

RKADK_PLAYER_EVENT_E RKADK_PLAYER_CFG_S

7.3.3 RKADK_PLAYER_CFG_S

说明

定义播放器属性结构体。

定义

typedef struct {
  RKADK_BOOL bEnableVideo;
  RKADK_BOOL bEnableAudio;
  RKADK_BOOL bEnableThirdDemuxer;
  RKADK_PLAYER_FRAME_INFO_S stFrmInfo;
  RKADK_PLAYER_RTSP_CFG_S stRtspCfg;
  RKADK_PLAYER_VDEC_CFG_S stVdecCfg;
  RKADK_PLAYER_SNAPSHOT_CFG_S stSnapshotCfg;
  RKADK_BOOL bEnableBlackBackground;
  RKADK_PLAYER_EVENT_FN pfnPlayerCallback;
} RKADK_PLAYER_CFG_S;

成员

相关数据类型及接口

RKADK_PLAYER_EVENT_FN RKADK_PLAYER_FRAME_INFO_S RKADK_PLAYER_RTSP_CFG_S RKADK_PLAYER_VDEC_CFG_S RKADK_PLAYER_SNAPSHOT_CFG_S RKADK_PLAYER_Create

7.3.4 RKADK_VO_FORMAT_E

说明

定义图像像素格式枚举类型。

定义

typedef enum {
  VO_FORMAT_ARGB8888 = 0,
  VO_FORMAT_ABGR8888,
  VO_FORMAT_RGB888,
  VO_FORMAT_BGR888,
  VO_FORMAT_ARGB1555,
  VO_FORMAT_ABGR1555,
  VO_FORMAT_RGB565,
  VO_FORMAT_RGB444,
  VO_FORMAT_NV12,
  VO_FORMAT_NV21
} RKADK_VO_FORMAT_E;

相关数据类型及接口

RKADK_PLAYER_FRAME_INFO_S

7.3.5 RKADK_VO_INTF_TYPE_E

说明

定义显示接口枚举类型。

定义

typedef enum {
  DISPLAY_TYPE_HDMI = 0,
  DISPLAY_TYPE_EDP,
  DISPLAY_TYPE_VGA,
  DISPLAY_TYPE_DP,
  DISPLAY_TYPE_HDMI_EDP,
  DISPLAY_TYPE_MIPI,
  DISPLAY_TYPE_DEFAULT,
} RKADK_VO_INTF_TYPE_E;

成员

相关数据类型及接口

RKADK_PLAYER_FRAME_INFO_S

7.3.6 RKADK_VO_SPLICE_MODE_E

说明

定义图层合成方式枚举类型。

定义

typedef enum {
  SPLICE_MODE_RGA = 0,
  SPLICE_MODE_GPU,
  SPLICE_MODE_BYPASS
} RKADK_VO_INTF_TYPE_E;

成员

相关数据类型及接口

RKADK_PLAYER_FRAME_INFO_S

7.3.7 RKADK_PLAYER_FRAME_INFO_S

说明

定义图像信息结构体。

定义

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_PLAYER_FRAMEINFO_S;

成员

注意

视频输出相关属性具体可参考Rockit 文档Rockchip_Developer_Guide_MPI.pdf VO章节。

相关数据类型及接口

RKADK_VO_FORMAT_E

RKADK_VO_INTF_TYPE_E RKADK_VO_SPLICE_MODE_E RKADK_PLAYER_Create

7.3.8 RKADK_PLAYER_STATE_E

说明

定义播放状态枚举类型。

定义

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_TPLAY,    /* The player is in the trick playing state, Reserved */
  RKADK_PLAYER_STATE_PAUSE,    /* The player is in the pause state */
  RKADK_PLAYER_STATE_ERR,      /* The player is in the err state */
  RKADK_PLAYER_STATE_BUTT
} RKADK_PLAYER_STATE_E;

相关数据类型及接口

RKADK_PLAYER_GetPlayStatus

7.3.9 RKADK_PLAYER_SNAPSHOT_S

说明

定义屏幕快照数据结构体。

定义

typedef struct {
  RKADK_U32 u32Width;
  RKADK_U32 u32Height;
  RKADK_U32 u32DataLen;
  RKADK_U8 *pu8DataBuf;
} RKADK_PLAYER_SNAPSHOT_S;

成员

相关数据类型及接口

RKADK_PPLAYER_SNAPSHOT_RECV_FN

7.3.10 RKADK_PPLAYER_SNAPSHOT_RECV_FN

说明

定义屏幕快照数据回调函数指针。

定义

typedef void (*RKADK_PPLAYER_SNAPSHOT_RECV_FN)(RKADK_PLAYER_SNAPSHOT_S *pstData);

成员

相关数据类型及接口

RKADK_PLAYER_SNAPSHOT_S RKADK_PLAYER_SNAPSHOT_CFG_S

7.3.11 RKADK_PLAYER_SNAPSHOT_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;

成员

相关数据类型及接口

RKADK_PPLAYER_SNAPSHOT_RECV_FN RKADK_PLAYER_CFG_S

7.3.12 RKADK_PLAYER_VDEC_CFG_S

说明

定义VDEC属性结构体。

定义

typedef struct {
  RKADK_U32 u32FrameBufCnt; //frame buffer cnt(output), default: 3
  RKADK_U32 u32StreamBufCnt; //stream buffer cnt(input), default: 3
} RKADK_PLAYER_VDEC_CFG_S;

成员

相关数据类型及接口

RKADK_PLAYER_CFG_S

7.3.13 RKADK_PLAYER_RTSP_CFG_S

说明

定义Rtsp属性结构体。

定义

typedef struct {
  const char *transport; //udp or tcp, default: udp
  RKADK_U32 u32IoTimeout; //timeout (in microseconds) of socket I/O operations
} RKADK_PLAYER_RTSP_CFG_S;

成员

相关数据类型及接口

RKADK_PLAYER_CFG_S

7.3.14 RKADK_PLAYER_PACKET

说明

定义数据包结构体,使能第三方demuxer库是使用。

定义

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;

成员

相关数据类型及接口

RKADK_PLAYER_SendAudioPacket RKADK_PLAYER_SendVideoPacket

7.3.15 RKADK_PLAYER_DATA_PARAM_S

说明

定义音视频参数结构体,使能第三方demuxer库时使用。

定义

typedef struct {
  const RKADK_CHAR *pFilePath;
  RKADK_BOOL bIsRtsp;
  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;

成员

相关数据类型及接口

RKADK_PLAYER_SetDataParam

8. 直播

8.1 概述

提供标准RTSP直播流的基本服务;提供RTMP直播服务。RTSP和RTMP不支持同时启动。

8.2 API参考

8.2.1 RTSP

8.2.1.1 RKADK_RTSP_Init

描述

初始化RTSP模块。

语法

RKADK_S32 RKADK_RTSP_Init(RKADK_U32 u32CamId, RKADK_U32 port, const char *path, RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_rtsp.h 库文件:librkadk.so

注意

RKADK_RTSP_Init 后调用RKADK_RTSP_Start 启动RTSP直播推流。

举例

rkadk_rtsp_test

相关主题

RKADK_RTSP_DeInit

8.2.1.2 RKADK_RTSP_DeInit

描述

反初始化RTSP模块。

语法

RKADK_S32 RKADK_RTSP_DeInit(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_rtsp.h 库文件:librkadk.so

举例

rkadk_rtsp_test

相关主题

RKADK_RTSP_Init

8.2.1.3 RKADK_RTSP_Start

描述

启动RTSP直播。

语法

RKADK_S32 RKADK_RTSP_Start(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_rtsp.h 库文件:librkadk.so

注意

RKADK_RTSP_Init 后调用该接口。

举例

rkadk_rtsp_test

相关主题

RKADK_RTSP_Stop

8.2.1.4 RKADK_RTSP_Stop

描述

停止RTSP直播。

语法

RKADK_S32 RKADK_RTSP_Stop(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_rtsp.h 库文件:librkadk.so

举例

rkadk_rtsp_test

相关主题

RKADK_RTSP_Start

8.2.1.5 RKADK_RTSP_VideoReset

描述

重新设置RTSP Video。

语法

RKADK_S32 RKADK_RTSP_VideoReset(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_rtsp.h

库文件:librkadk.so

注意

RTSP初始化后,才能使用RKADK_RTSP_VideoReset接口。 切换分辨率、帧率、比特率、编码类型、录像类型时,结合RKADK_PARAM_SetCamParam API重置ini文件中 Live模块的参数 RV1126/RV1109、RK3576不支持动态切换分辨率和编码类型,需要先RKADK_RTSP_DeInit,然后配置新的分 辨率,再重新RKADK_RTSP_Init。 如果Live和其他模块复用VI通道,需要同时切换Live和复用模块的分辨率,否则会导致VI和VENC分辨率不匹 配。

8.2.2 RTMP

8.2.2.1 RKADK_RTMP_Init

描述

初始化RTMP模块。

语法

RKADK_S32 RKADK_RTMP_Init(RKADK_U32 u32CamId, const char *path, RKADK_MW_PTR *ppHandle);

参数

返回值

需求

头文件:rkadk_rtmp.h 库文件:librkadk.so

举例

rkadk_rtmp_test

相关主题

RKADK_RTMP_DeInit

8.2.2.2 RKADK_RTMP_DeInit

描述

反初始化RTMP模块。

语法

RKADK_S32 RKADK_RTMP_DeInit(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_rtmp.h 库文件:librkadk.so

举例

rkadk_rtmp_test

相关主题

RKADK_RTMP_Init

8.2.2.3 RKADK_RTMP_VideoReset

描述

重新设置RTMP Video。

语法

RKADK_S32 RKADK_RTMP_VideoReset(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_rtmp.h 库文件:librkadk.so

注意

RTMP初始化后,才能使用RKADK_RTMP_VideoReset接口。 切换分辨率、帧率、比特率、编码类型、录像类型时,结合RKADK_PARAM_SetCamParam API重置ini文件中 Live模块的参数 RV1126/RV1109、RK3576不支持动态切换分辨率和编码类型,需要先RKADK_RTMP_DeInit,然后配置新的 分辨率,再重新RKADK_RTMP_Init。 如果Live和其他模块复用VI通道,需要同时切换Live和复用模块的分辨率,否则会导致VI和VENC分辨率不匹 配。

9. 存储

9.1 概述

提供基本的存储功能,目前包含如下功能: 文件检测、存储、获取、管理 设备容量和状态查询 自动删除文件 格式化

9.2 API参考

9.2.1 RKADK_STORAGE_Init

描述

存储模块初始化。

语法

RKADK_S32 RKADK_STORAGE_Init(RKADK_MW_PTR *ppHandle, RKADK_STR_DEV_ATTR *pstDevAttr);

参数

返回值

需求

头文件:rkadk_storage.h 库文件:librkadk.so

注意

不支持重复初始化。 RKADK_STR_DEV_ATTR传入NULL使用默认属性,默认属性为:2个文件夹、命名为video_front和 video_back、以文件名排序、自动删除阈值500~1000M、不使用文件个数限制、限制比例为50%。

举例

rkadk_storage_test

相关主题

RKADK_STORAGE_Deinit

9.2.2 RKADK_STORAGE_Deinit

描述

存储模块反初始化。

语法

RKADK_S32 RKADK_STORAGE_Deinit(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_storage.h 库文件:librkadk.so

注意

不支持重复反初始化。

举例

rkadk_storage_test

相关主题

RKADK_STORAGE_Init

9.2.3 RKADK_STORAGE_GetDevAttr

描述

获取挂载设备属性。

语法

RKADK_STR_DEV_ATTR RKADK_STORAGE_GetDevAttr(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_storage.h 库文件:librkadk.so

注意

存储模块初始化后,才能使用RKADK_STORAGE_GetDevAttr接口。

举例

无

相关主题

无

9.2.4 RKADK_STORAGE_GetMountStatus

描述

获取设备挂载状态。

语法

RKADK_MOUNT_STATUS RKADK_STORAGE_GetMountStatus(RKADK_MW_PTR pHandle);

参数

返回值

需求

头文件:rkadk_storage.h

库文件:librkadk.so

举例

rkadk_storage_test

相关主题

无

9.2.5 RKADK_STORAGE_GetCapacity

描述

获取设备容量。

语法

RKADK_S32 RKADK_STORAGE_GetCapacity(RKADK_MW_PTR *ppHandle, RKADK_S32 *totalSize, RKADK_S32 *freeSize);

参数

返回值

需求

头文件:rkadk_storage.h 库文件:librkadk.so

举例

rkadk_storage_test

相关主题

无

9.2.6 RKADK_STORAGE_GetFileList

描述

获取文件列表。

语法

RKADK_S32 RKADK_STORAGE_GetFileList(RKADK_FILE_LIST *list, RKADK_MW_PTR pHandle, RKADK_SORT_TYPE sort);

参数