Руководство по разработке приложений Rockchip RKADK

Основа - китайский и английский документы Rockchip RKADK V2.3.2. Сохранены 14 технических глав, API, определения типов и примеры. Для применения на ArmSoM проверьте конкретную плату, SoC, SDK/BSP, ядро и периферию; поддержка всех плат ArmSoM не заявляется. Примеры взяты из источников. Команды и аппаратные испытания не выполнялись.

В китайской главе 3 обзор, API и типы имеют номера 3.1, 3.2, 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. Определение структуры ручного разделения заканчивается именем 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 Обзор

Базовые функции записи видео: создание и уничтожение задач, запуск и остановка задач, ручное разделение файлов, интервальная запись, предварительная запись и запись «картинка в картинке» (PiP). Задачи получают сведения о видео и аудио из модуля параметров, запускают и останавливают VENC и AENC, а через модуль мультиплексирования создают файлы и записывают кадры. Каждой задаче соответствует один или несколько файлов. Для каждого файла требуется канал видеокодирования; при записи звука добавляется канал аудиокодирования. Файлы одной задачи имеют одинаковый тип записи и условия разделения, а при интервальной записи - одинаковый интервал. Длительность записи может задаваться отдельно.

Post AI ISP: RV1106/RV1126/RV1109 поддерживают подавление шума при слабом освещении и интеллектуальное улучшение выходных изображений VI через AI ISP. Это позволяет получать более чёткое изображение с меньшим шумом и без шлейфов даже при слабом освещении.

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.

Примечание

Одна задача поддерживает одновременную запись не более двух файлов. Каждый файл содержит как минимум один видеопоток; максимум - один видеопоток и один аудиопоток. Повторное создание той же задачи не поддерживается. После создания для начала записи вызовите RKADK_RECORD_Start. Для PiP включите stPipAttr при RKADK_RECORD_Create, чтобы создать тракт «картинка в картинке».

Пример

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 разрешён только после создания задачи. При смене разрешения, частоты кадров, битрейта, типа кодирования или записи измените параметры Record в ini через RKADK_PARAM_SetCamParam. RV1126/RV1109 и RK3576 не поддерживают динамическую смену разрешения и типа кодирования.

Сначала вызовите RKADK_RECORD_Destroy, задайте новое разрешение или тип кодирования, затем снова вызовите RKADK_RECORD_Create. Если Record делит канал VI с другими модулями, переключайте разрешение всех этих модулей одновременно, чтобы разрешения 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

Описание

Получить ID канала AENC записи.

Синтаксис

RKADK_S32 RKADK_RECORD_GetAencChn();

Возвращаемое значение

ID канала 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 позволяет задать тип и разрешение выходного изображения. Используйте вместе с 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

Описание

Задать поворот записи.

Синтаксис

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

Описание

Задать зеркальное отражение записи.

Синтаксис

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

Описание

Задать переворот записи.

Синтаксис

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; механизм кэширования ядра не действует.

Синтаксис

RKADK_S32 RKADK_RECORD_FileCacheInit(FILE_CACHE_ARG *pstFileCacheAttr)

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_record.h. Библиотека: librkadk.so.

Примечание

По умолчанию 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 включён, при смене типа записи задайте новый тип File Cache через этот API. rkadk_aov_record_test.

2.2.19 RKADK_MEDIA_EnablePostIsp

Описание

Включить Post AI ISP. Помимо этого интерфейса, функцию можно включить параметром post_aiisp в ini-файле сенсора.

Синтаксис

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.

2.2.21 RKADK_RECORD_SetPipAttr

Описание

Динамически задать атрибуты PiP.

Синтаксис

RKADK_S32 RKADK_RECORD_SetPipAttr(RKADK_MW_PTR pRecorder, RKADK_PIP_ATTR_S *pstPipAttr);

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_record.h.

Библиотека: librkadk.so. Примечание: для PiP включите stPipAttr при RKADK_RECORD_Create, чтобы создать соответствующий тракт.

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_MOUNT_SDCARD_FN - функция монтирования SD; RKADK_AOV_ATTR_S - атрибуты AOV; RKADK_PIP_ATTR_S - атрибуты PiP.

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

Описание

Максимальное поддерживаемое число сенсоров; можно изменить согласно конкретной конфигурации

Определение

#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_MOUNT_SDCARD_FN

Описание

Указатель функции монтирования SD-карты.

Определение

typedef int (*RKADK_MOUNT_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 MUXER_MANUAL_SPLIT_ATTR_S RKADK_REC_MANUAL_SPLIT_ATTR_S;

Связанные типы данных и интерфейсы

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;

Поля

Связанные типы данных и интерфейсы

RKADK_RECORD_FileCacheInit

FILE_CACHE_ARG

2.3.14 FILE_SDCARD_ARG

Описание

Структура атрибутов SD-карты.

Определение

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 Справочник API

3.1.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.1.2 RKADK_MUXER_Destroy

Описание

Уничтожить мультиплексор.

Синтаксис

RKADK_S32 RKADK_MUXER_Destroy(RKADK_MW_PTR pHandle);

Параметры

Возвращаемые значения

Требования

Заголовочный файл: rkadk_muxer.h. Библиотека: librkadk.so.

Примечания

Уничтожать можно только созданный мультиплексор; повторное уничтожение не поддерживается. Перед уничтожением остановите его через RKADK_MUXER_Stop, затем отключите через RKADK_MUXER_Disable.

Пример

rkadk_muxer_test.

Связанные темы

RKADK_MUXER_Create

3.1.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_Disable.

3.1.4 RKADK_MUXER_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.1.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.1.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.1.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.1.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.1.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.1.10 RKADK_MUXER_Reset

Описание

Сбросить мультиплексор.

Синтаксис

RKADK_S32 RKADK_MUXER_Reset(RKADK_MW_PTR pHandle);

Параметры

Возвращаемые значения

Требования

Заголовочный файл: rkadk_muxer.h. Библиотека: librokadk.so.

Примечания

До RKADK_MUXER_Reset вызовите RKADK_MUXER_SetResetState для перехода в состояние сброса. После RKADK_MUXER_Reset вызовите RKADK_MUXER_ResetParam для перенастройки параметров, затем снова RKADK_MUXER_SetResetState для выхода из состояния сброса.

Пример

rkadk_muxer_test.

Связанные темы

RKADK_MUXER_ResetParam RKADK_MUXER_SetResetState

3.1.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.1.12 RKADK_MUXER_SetResetState

Описание

Задать состояние сброса мультиплексора.

Синтаксис

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.1.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.1.14 RKADK_MUXER_WriteVideoFrame

Описание

Записать данные видеопотока.

Синтаксис

int RKADK_MUXER_WriteVideoFrame(RKADK_MUXER_DATA_S stData, void *handle);

Параметры

Возвращаемые значения

Требования

Заголовочный файл: rkadk_muxer.h. Библиотека: librkadk.so.

Пример

rkadk_muxer_test.

3.1.15 RKADK_MUXER_WriteAudioFrame

Описание

Записать данные аудиопотока.

Синтаксис

int RKADK_MUXER_WriteAudioFrame(RKADK_MUXER_DATA_S stData, void *handle);

Параметры

Возвращаемые значения

Требования

Заголовочный файл: rkadk_muxer.h. Библиотека: librkadk.so.

Пример

rkadk_muxer_test.

3.2 Типы данных

Основные типы модуля Muxer: 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 - информация о миниатюре; RKADK_THIRD_MUXER_ATTR_S - атрибуты стороннего мультиплексора.

3.2.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.2.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.2.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.2.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

3.2.5 RKADK_MUXER_EVENT_CALLBACK_FN

Описание

Указатель обратного вызова событий мультиплексора.

Определение

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

Связанные типы данных и интерфейсы

RKADK_MUXER_EVENT_INFO_S

3.2.6 RKADK_REC_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.2.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_REC_MANUAL_SPLIT_ATTR_S

3.2.8 RKADK_THIRD_MUXER_ATTR_S

Описание

Структура атрибутов стороннего мультиплексора.

Определение

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_GetthmInMp4 и RKADK_GetthmInMp4Ex не поддерживают получение миниатюр видео.

Связанные типы данных и интерфейсы

RKADK_MUXER_ATTR_S

3.2.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;

Поля

Связанные типы данных и интерфейсы

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.2.10 RKADK_MUXER_REC_TYPE_E

Описание

Перечисление типов записи мультиплексора.

Определение

typedef enum {
  RKADK_REC_TYPE_NORMAL = 0, /* normal record */
  RKADK_REC_TYPE_LAPSE,      /* time lapse record */
  RKADK_REC_TYPE_AOV_LAPSE,  /* low power time lapse record */
  RKADK_REC_TYPE_BUTT
} RKADK_MUXER_REC_TYPE_E;

Поля

Связанные типы данных и интерфейсы

Нет. Примечание: интервальную запись AOV поддерживают только RV1126, RV1106 и RV1126B.

3.2.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.2.12 RKADK_MUXER_REQUEST_FILE_NAME_CB

Описание

Указатель обратного вызова запроса имён файлов.

Определение

typedef int (*RKADK_MUXER_REQUEST_FILE_NAME_CB)(void *pHandle, char *pcFileName, unsigned
int u32MuxerId);

Поля

Связанные типы данных и интерфейсы

RKADK_MUXER_ATTR_S

3.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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.2.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 (непрерывная видеозапись)

4.1 Обзор

AOV (Always On Video) - непрерывная запись с низкой частотой кадров на основе циклов сна и пробуждения. При событии, например обнаружении ИИ, срабатывании PIR или пробуждении по Wi-Fi, можно вернуться к обычной частоте кадров. Рекомендуется включить файловый кэш; см. RKADK_RECORD_FileCacheInit и RKADK_RECORD_FileCacheDeInit в главе о записи. Для снижения энергопотребления при интервальной записи AOV питание SD-карты во сне отключают; перед засыпанием приложение должно её размонтировать. При включённом файловом кэше он пытается монтировать карту во время записи и защищает операцию, чтобы карта не была размонтирована до её завершения. Процесс 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 в мс.

Синтаксис

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. При JPEG Slice данные VI кодируются в JPEG по сегментам для экономии памяти. При увеличении JPEG данные VI сначала увеличиваются интерполяцией по сегментам, затем сегментами кодируются в JPEG. Высота сегмента должна быть кратна 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 разрешён только после инициализации задачи записи (термин оригинала). При смене разрешения измените разрешение Photo в ini через RKADK_PARAM_SetCamParam. RV1126/RV1109 и RK3576 не поддерживают динамическую смену разрешения: сначала RKADK_PHOTO_DeInit, затем настройка нового разрешения и RKADK_PHOTO_Init. Если Photo и другие модули делят канал VI, меняйте их разрешения одновременно, чтобы 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

См. также

No.

5.2.6 RKADK_PHOTO_GetThmInJpgEx

Описание

Расширенный интерфейс извлечения миниатюры из 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.

Синтаксис

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.

Синтаксис

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  /* Supports the maximum number of MPF thumbnails to
be generated simultaneously */

typedef struct rkSIZE_S {
  RK_U32 u32Width;               /* Thumbnail width*/
  RK_U32 u32Height;              /* Thumbnail height */
} SIZE_S;

typedef enum {
  RKADK_PHOTO_MPF_SINGLE = 0,    /* Single MPF thumbnail */
  RKADK_PHOTO_MPF_MULTI,         /* Multiple MPF thumbnails */
  RKADK_PHOTO_MPF_BUTT
} RKADK_PHOTO_MPF_MODE_E;

typedef struct {
  RKADK_U8 u8LargeThumbNum;      /* Number of generated MPF thumbnails*/
  SIZE_S astLargeThumbSize[RKADK_MPF_LARGE_THUMB_NUM_MAX];  /* Each thumbnail resolution */
} RKADK_PHOTO_MPF_CFG_S;
typedef struct {
  RKADK_PHOTO_MPF_MODE_E eMode;  /* MPF thumbnail mode */
  RKADK_PHOTO_MPF_CFG_S sCfg;    /* MPF thumbnail configuration */
} 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 Обзор

Обратные вызовы предварительного просмотра позволяют получать сведения о видео и аудио, запускать и останавливать VENC/AENC и регистрировать функции обработки кадров аудио и видео.

6.2 Справочник API

6.2.1 RKADK_STREAM_VideoInit

Описание

Инициализировать видеомодули VI и VENC.

Синтаксис

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

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_stream.h. Библиотека: librkadk.so.

Примечание

Повторная инициализация видеомодуля не поддерживается.

Пример

rkadk_stream_test

См. также

RKADK_STREAM_VideoDeInit

6.2.2 RKADK_STREAM_VideoDeInit

Описание

Деинициализировать видеомодули 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.

Примечание

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

Описание

Перенастроить потоковое видео.

Синтаксис

RKADK_S32 RKADK_STREAM_VideoReset(RKADK_MW_PTR pHandle);

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_stream.h. Библиотека: librkadk.so.

Примечание

RKADK_STREAM_VideoReset разрешён только после RKADK_STREAM_VideoInit. При смене разрешения, частоты кадров, битрейта, типа кодирования или записи измените параметры Preview в ini через RKADK_PARAM_SetCamParam. RV1126/RV1109 и RK3576 не поддерживают динамическую смену разрешения и типа кодирования: сначала RKADK_STREAM_VideoDeInit, затем новые параметры и RKADK_STREAM_VideoInit. Если Preview делит канал VI с другими модулями, переключайте разрешение всех этих модулей одновременно, чтобы VI и VENC совпадали.

Пример

rkadk_stream_test

6.2.6 RKADK_STREAM_GetVideoInfo

Описание

Получить сведения о видео.

Синтаксис

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

Описание

Инициализировать аудиомодули AI и AENC.

Синтаксис

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

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_stream.h. Библиотека: librkadk.so.

Примечание

Повторная инициализация аудиомодуля не поддерживается.

Пример

rkadk_stream_test

См. также

RKADK_STREAM_AudioDeInit

6.2.8 RKADK_STREAM_AudioDeInit

Описание

Деинициализировать аудиомодули 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.

Примечание

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

Описание

Получить сведения об аудио.

Синтаксис

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 - видеопоток; RKADK_VENC_DATA_PACK_S - пакет VENC; RKADK_VENC_DATA_TYPE_S - тип пакета VENC; RKADK_VIDEO_INFO_S - сведения о видео; RKADK_STREAM_VIDEO_ATTR_S - атрибуты видеозадачи; RKADK_AUDIO_DATA_PROC_FUNC - обратный вызов аудиоданных; RKADK_AUDIO_STREAM_S - аудиоданные; RKADK_AUDIO_INFO_S - сведения об аудио; RKADK_STREAM_AUDIO_ATTR_S - атрибуты аудиозадачи.

6.3.1 RKADK_CODEC_TYPE_E

Описание

Перечисление форматов кодирования. По умолчанию аудиокодирование 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

Описание

Структура видеопотока.

Определение

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

Описание

Структура сведений о видео.

Определение

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

Описание

Структура атрибутов видеозадачи.

Определение

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

Описание

Структура потока аудиоданных.

Определение

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

Описание

Структура сведений об аудио.

Определение

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

Описание

Структура атрибутов аудиозадачи.

Определение

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 с управлением воспроизведением, паузой, переходом и снимком экрана. Функция 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 включена сторонняя библиотека демультиплексирования, следует использовать 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 включена сторонняя библиотека демультиплексирования; иначе используйте 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_Play можно вызывать только после RKADK_PLAYER_Prepare.

Пример

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_Seek можно вызывать только после RKADK_PLAYER_Play.

Пример

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

Описание

Снимок экрана проигрывателя: этот интерфейс кодирует текущее отображаемое изображение в JPEG. Приложение получает созданные данные JPEG, зарегистрировав обратный вызов RKADK_PPLAYER_SNAPSHOT_RECV_FN.

Синтаксис

RKADK_S32 RKADK_PLAYER_Snapshot(RKADK_MW_PTR pPlayer);

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_player.h. Библиотека: librkadk.so.

Пример

rkadk_player_test

См. также

Нет

7.2.14 RKADK_PLAYER_SendAudioPacket

Описание

При включенной сторонней библиотеке демультиплексирования этот интерфейс передает распакованные аудиоданные в 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 для декодирования и воспроизведения.

Синтаксис

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.

Пример

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;

Поля

Примечание

Подробные атрибуты видеовыхода описаны в главе VO документа Rockit Rockchip_Developer_Guide_MPI.pdf.

Связанные типы данных и интерфейсы

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

Описание

Определить структуру пакета данных для использования сторонней библиотеки демультиплексирования.

Определение

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

Описание

Определить структуру параметров аудио и видео для работы со сторонней библиотекой демультиплексирования.

Определение

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.

Синтаксис

RKADK_S32 RKADK_RTSP_VideoReset(RKADK_MW_PTR pHandle);

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_rtsp.h

Библиотека: librkadk.so

Примечание

RKADK_RTSP_VideoReset можно использовать только после RKADK_RTSP_Init. При изменении разрешения, частоты кадров, битрейта, типа кодирования или записи перенастройте параметры модуля Live в ini-файле через RKADK_PARAM_SetCamParam. 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_RTSP_VideoReset

Описание

Перенастроить прямую трансляцию RTSP.

Синтаксис

RKADK_S32 RKADK_RTSP_VideoReset(RKADK_MW_PTR pHandle);

Параметры

Возвращаемое значение

Требования

Заголовочный файл: rkadk_rtsp.h. Библиотека: librkadk.so

Примечание

RKADK_RTMP_VideoReset можно использовать только после RKADK_RTMP_Init. При изменении разрешения, частоты кадров, битрейта, типа кодирования или записи перенастройте параметры модуля Live в ini-файле через RKADK_PARAM_SetCamParam. 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);

Параметры

Возвращаемое значение