Rockchip RKADK: Handbuch zur Anwendungsentwicklung

Grundlage sind die chinesischen und englischen Rockchip-RKADK-Dokumente V2.3.2. Alle 14 technischen Kapitel, APIs, Typdefinitionen und Beispiele bleiben erhalten. Für ArmSoM konkrete Platine, SoC, SDK/BSP, Kernel und Peripherie prüfen; die Unterstützung aller ArmSoM-Platinen wird nicht zugesichert. Die Beispiele stammen aus den Quellen. Es wurden keine Befehle oder Hardwaretests ausgeführt.

In Kapitel 3 nummeriert Chinesisch Überblick, API und Datentypen als 3.1, 3.2 und 3.3. Englisch lässt den Überblick unnummeriert und verwendet 3.1/3.2 für API/Typen. Die jeweilige Quellnummerierung bleibt erhalten. Die chinesische Überschrift 3.3.6 lautet RKADK_MUXER_MANUAL_SPLIT_ATTR_S, die englische 3.2.6 RKADK_REC_MANUAL_SPLIT_ATTR_S; den Typ an den SDK-Headern prüfen. Die englische Deklaration von RKADK_RECORD_Single_Stop schreibt RKADK_STREAM_TYPE_EenStrmType zusammen; die Quellschreibweise bleibt erhalten, die Trennung von Typ und Parameter ist am SDK zu prüfen.

Beide Quellen sind auf 2025-08-04 datiert. Die Struktur für manuelles Aufteilen endet mit dem typedef-Namen MUXER_MANUAL_SPLIT_ATTR_S; die folgende Typaufzählung endet entgegen ihrer Überschrift mit RKADK_MUXER_MANUAL_SPLIT_ATTR_S. Diese Quelldefinitionen bleiben erhalten und sind keine geprüften kompilierbaren SDK-Header. Auch RKADK_MUXER_Disbale, librokadk.so, RGBA9888 und RV1103/RV1103 in der Player-Plattformliste sind Quellschreibweisen; am SDK prüfen. Leerzeichen an umgebrochenen Deklarationszeilen wurden wiederhergestellt, ohne Parameter, Zeiger oder Bezeichner zu ändern.

1. Systemübersicht

RKADK stellt grundlegende Komponenten für Videoaufzeichnung, Fotoaufnahme, Wiedergabe und Vorschau bereit und vereinfacht damit die schnelle Entwicklung von Audio-/Videoaufzeichnungsanwendungen. Der Baustein unterstützt nur einen Prozess; mehrere gleichzeitig arbeitende Prozesse werden, sofern nicht anders angegeben, nicht unterstützt.

1.1 Versionen

Version 1.x.x: zusätzliche Kapselung von rkmedia und rockit, Repository master. Version 2.x.x: zusätzliche Kapselung von rockit, Repository develop.

2. Aufzeichnung

2.1 Überblick

Grundlegende Videoaufzeichnung mit Erstellen und Zerstören sowie Starten und Stoppen von Aufgaben, manuellem Aufteilen von Dateien, Zeitraffer, Voraufzeichnung und Bild-in-Bild (PiP). Eine Aufgabe liest Video- und Audiodaten aus dem Parametermodul, startet und stoppt VENC und AENC und erstellt über den Muxer Dateien, in die sie Frames schreibt. Zu jeder Aufgabe gehören eine oder mehrere Dateien. Jede Datei benötigt einen Videokodierungskanal; für Ton kommt ein Audiokodierungskanal hinzu. Dateien derselben Aufgabe haben denselben Aufzeichnungstyp und dieselben Aufteilungsbedingungen, bei Zeitraffer auch dasselbe Intervall. Unterschiedliche Aufzeichnungsdauern sind möglich.

Post AI ISP: RV1106/RV1126/RV1109 unterstützen Rauschunterdrückung bei schwachem Licht und intelligente Verbesserung der VI-Ausgabebilder durch AI ISP. Dadurch entstehen auch bei wenig Licht klarere Bilder mit geringem Rauschen und ohne Nachzieheffekte.

2.2 API-Referenz

2.2.1 RKADK_RECORD_Create

Beschreibung

Videoaufzeichnungsaufgabe erstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

Eine Aufgabe unterstützt höchstens zwei gleichzeitige Aufzeichnungsdateien. Jede Datei enthält mindestens einen Videostream und höchstens einen Video- und einen Audiostream. Wiederholtes Erstellen derselben Aufgabe wird nicht unterstützt. Nach dem Erstellen startet RKADK_RECORD_Start die Aufnahme. PiP muss beim Aufruf von RKADK_RECORD_Create über stPipAttr aktiviert werden; dadurch wird der PiP-Pfad erzeugt.

Beispiel

rkadk_record_test.

Siehe auch

RKADK_RECORD_Destroy.

2.2.2 RKADK_RECORD_Destroy

Beschreibung

Videoaufzeichnungsaufgaben zerstören.

Syntax

RKADK_S32 RKADK_RECORD_Destroy(RKADK_MW_PTR pRecorder);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

RKADK_RECORD_Destroy darf erst nach dem Erstellen einer Aufgabe aufgerufen werden. Nur erstellte Aufgaben können zerstört werden; wiederholtes Zerstören derselben Aufgabe wird nicht unterstützt.

Beispiel

rkadk_record_test.

Siehe auch

RKADK_RECORD_Create

2.2.3 RKADK_RECORD_Start

Beschreibung

Aufzeichnungsaufgabe starten.

Syntax

RKADK_S32 RKADK_RECORD_Start(RKADK_MW_PTR pRecorder);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

RKADK_RECORD_Start darf erst nach dem Erstellen der Aufgabe aufgerufen werden. Eine gestoppte Aufgabe kann erneut gestartet werden.

Beispiel

rkadk_record_test.

Siehe auch

RKADK_RECORD_Stop

2.2.4 RKADK_RECORD_Stop

Beschreibung

Aufzeichnungsaufgabe stoppen.

Syntax

RKADK_S32 RKADK_RECORD_Stop(RKADK_MW_PTR pRecorder);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

RKADK_RECORD_Stop darf erst nach dem Erstellen der Aufgabe aufgerufen werden. Wiederholtes Stoppen derselben Aufgabe wird nicht unterstützt.

Beispiel

rkadk_record_test.

Siehe auch

RKADK_RECORD_Start

2.2.5 RKADK_RECORD_Single_Start

Beschreibung

Aufzeichnung des angegebenen Streams starten.

Syntax

RKADK_S32 RKADK_RECORD_Single_Start(RKADK_MW_PTR pRecorder, RKADK_STREAM_TYPE_E enStrmType);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweise

RKADK_RECORD_Single_Start darf erst nach dem Erstellen der Aufgabe aufgerufen werden und wird zusammen mit RKADK_RECORD_Single_Stop verwendet. Nach dem Stoppen ist ein erneuter Start möglich.

Beispiel

rkadk_record_test.

Verwandte Themen

RKADK_RECORD_Single_Stop.

2.2.6 RKADK_RECORD_Single_Stop

Beschreibung

Aufzeichnung des angegebenen Streams stoppen.

Syntax

RKADK_S32 RKADK_RECORD_Single_Stop(RKADK_MW_PTR pRecorder, RKADK_STREAM_TYPE_EenStrmType);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweise

RKADK_RECORD_Stop darf erst nach dem Erstellen der Aufgabe aufgerufen werden und wird zusammen mit RKADK_RECORD_Single_Start verwendet. Wiederholtes Stoppen derselben Aufgabe wird nicht unterstützt.

Beispiel

rkadk_record_test.

Verwandte Themen

RKADK_RECORD_Single_Start

2.2.7 RKADK_RECORD_Reset

Beschreibung

Aufzeichnungsaufgabe neu konfigurieren.

Syntax

RKADK_S32 RKADK_RECORD_Reset(RKADK_MW_PTR *ppRecorder);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

RKADK_RECORD_Reset darf erst nach dem Erstellen der Aufgabe aufgerufen werden. Bei Änderung von Auflösung, Framerate, Bitrate, Kodierungs- oder Aufzeichnungstyp die Record-Parameter in der ini-Datei über RKADK_PARAM_SetCamParam anpassen. RV1126/RV1109 und RK3576 unterstützen keinen dynamischen Wechsel von Auflösung und Kodierungstyp.

Zuerst RKADK_RECORD_Destroy aufrufen, dann die neue Auflösung oder den Kodierungstyp einstellen und anschließend erneut RKADK_RECORD_Create aufrufen. Teilen sich Record und andere Module den VI-Kanal, müssen ihre Auflösungen gleichzeitig umgestellt werden, damit VI und VENC übereinstimmen.

Beispiel

rkadk_record_test.

Siehe auch

Keine

2.2.8 RKADK_RECORD_ManualSplit

Beschreibung

Videodateien manuell aufteilen.

Syntax

RKADK_S32 RKADK_RECORD_ManualSplit(RKADK_MW_PTR pRecorder, RKADK_REC_MANUAL_SPLIT_ATTR_S *pstSplitAttr);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

RKADK_RECORD_ManualSplit darf erst nach dem Erstellen der Aufgabe aufgerufen werden. Erneutes manuelles Aufteilen ist auch vor Abschluss der vorherigen Aufteilung möglich.

Beispiel

rkadk_record_test.

Siehe auch

Nein

2.2.9 RKADK_RECORD_GetAencChn

Beschreibung

ID des AENC-Kanals für die Aufzeichnung abrufen.

Syntax

RKADK_S32 RKADK_RECORD_GetAencChn();

Rückgabewert

ID des für die Aufzeichnung verwendeten AENC-Kanals.

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

2.2.10 RKADK_GetThmInMp4

Beschreibung

Vorschaubilddaten aus MP4-Dateien abrufen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_thumb.h. Bibliothek: librkadk.so.

Beispiel

rkadk_thumb_test

Siehe auch

Keine

2.2.11 RKADK_GetThmInMp4Ex

Beschreibung

Die erweiterte Schnittstelle zum Abrufen von MP4-Vorschaubildern unterstützt die Angabe von Typ und Auflösung des Ausgabebildes. Zusammen mit RKADK_ThmBufFree verwenden.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_thumb.h. Bibliothek: librkadk.so.

Beispiel

rkadk_thumb_test

Siehe auch

RKADK_ThmBufFree

2.2.12 RKADK_ThmBufFree

Beschreibung

Von RKADK_GetThmInMp4Ex angeforderten Speicher freigeben. Zusammen mit RKADK_GetThmInMp4Ex verwenden.

Syntax

RKADK_S32 RKADK_ThmBufFree(RKADK_THUMB_ATTR_S *pstThumbAttr);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_thumb.h. Bibliothek: librkadk.so.

Beispiel

rkadk_thumb_test

Siehe auch

RKADK_GetThmInMp4Ex

2.2.13 RKADK_RECORD_SetRotation

Beschreibung

Drehung der Aufnahme einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Beispiel

rkadk_record_test

2.2.14 RKADK_RECORD_ToggleMirror

Beschreibung

Spiegelung der Aufnahme einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

2.2.15 RKADK_RECORD_ToggleFlip

Beschreibung

Vertikales Spiegeln der Aufnahme einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

2.2.16 RKADK_RECORD_FileCacheInit

Beschreibung

Die Initialisierung von File Cache glättet Dateischreibvorgänge. Bei aktiviertem File Cache werden Dateien über DirectIO auf das Speichermedium geschrieben; der Cache des Kernels ist dabei unwirksam.

Syntax

RKADK_S32 RKADK_RECORD_FileCacheInit(FILE_CACHE_ARG *pstFileCacheAttr)

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

File Cache ist standardmäßig deaktiviert. Zum Aktivieren die Umgebungsvariable file_cache_env setzen.

export file_cache_env=1

Bei aktiviertem File Cache diese Schnittstelle einmal vor RKADK_RECORD_Create aufrufen; andernfalls ist kein Aufruf erforderlich. File Cache benötigt zusätzlichen Speicher entsprechend u32TotalCache. Paarweise mit RKADK_RECORD_FileCacheDeInit verwenden.

Beispiel

rkadk_record_test

2.2.17 RKADK_RECORD_FileCacheDeInit

Beschreibung

File Cache deinitialisieren

Syntax

RKADK_S32 RKADK_RECORD_FileCacheDeInit();

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweis

Zusammen mit RKADK_RECORD_FileCacheInit verwenden. Bei aktiviertem File Cache nach RKADK_RECORD_Destroy aufrufen; andernfalls ist kein Aufruf nötig. rkadk_record_test.

2.2.18 RKADK_RECORD_FileCacheSetMode

Beschreibung

Aufzeichnungstyp für File Cache einstellen.

Syntax

void RKADK_RECORD_FileCacheSetMode(RKADK_REC_TYPE_E enRecType);

Parameter

Voraussetzungen

Headerdatei: rkadk_record.h. Bibliothek: librkadk.so.

Hinweise

Bei aktiviertem File Cache muss beim Wechsel des Aufzeichnungstyps dessen neuer Typ über diese API gesetzt werden. rkadk_aov_record_test.

2.2.19 RKADK_MEDIA_EnablePostIsp

Beschreibung

Post AI ISP aktivieren. Zusätzlich zur Schnittstelle lässt sich Post AI ISP über post_aiisp in der Sensor-ini aktivieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_media_comm.h. Bibliothek: librkadk.so.

2.2.20 RKADK_MEDIA_SetPostIspAttr

Beschreibung

Post-AI-ISP-Attribute dynamisch einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_media_comm.h. Bibliothek: librkadk.so.

2.2.21 RKADK_RECORD_SetPipAttr

Beschreibung

Bild-in-Bild-Attribute (PiP) dynamisch einstellen.

Syntax

RKADK_S32 RKADK_RECORD_SetPipAttr(RKADK_MW_PTR pRecorder, RKADK_PIP_ATTR_S *pstPipAttr);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_record.h.

Bibliothek: librkadk.so. Hinweis: PiP beim Aufruf von RKADK_RECORD_Create über stPipAttr aktivieren; dadurch wird der PiP-Pfad erstellt.

2.3 Datentypen

Wichtige Datentypen des Aufzeichnungsmoduls: RKADK_MW_PTR - Aufgabenzeiger; RECORD_FILE_NUM_MAX - maximale Anzahl gleichzeitig aufgezeichneter Dateien einer Aufgabe; RKADK_REC_EVENT_CALLBACK_FN - Ereignis-Callback; RKADK_REC_TYPE_E - Aufzeichnungstypen; RKADK_REC_REQUEST_FILE_NAMES_FN - Funktion zum Anfordern von Dateinamen; RKADK_REC_PTS_CALLBACK_FN - Callback für Videoframe-Zeitstempel; RKADK_RECORD_ATTR_S - Aufgabenattribute; RKADK_REC_MANUAL_SPLIT_ATTR_S - manuelle Aufteilung; FILE_CACHE_ARG - File-Cache-Attribute; RKADK_POST_ISP_ATTR_S - Post-AI-ISP-Attribute; RKADK_MOUNT_SDCARD_FN - SD-Mount-Funktion; RKADK_AOV_ATTR_S - AOV-Attribute; RKADK_PIP_ATTR_S - PiP-Attribute.

2.3.1 Allgemeine Datentypen

Beschreibung

Definition der grundlegenden Datentypen.

Definition

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

Beschreibung

Aufgabenzeiger definieren

Definition

typedef RKADK_VOID *RKADK_MW_PTR;

2.3.3 RKADK_MAX_SENSOR_CNT

Beschreibung

Maximale unterstützte Sensoranzahl; an die konkrete Konfiguration anpassbar

Definition

#define RKADK_MAX_SENSOR_CNT 8

2.3.4 RECORD_FILE_NUM_MAX

Beschreibung

Maximale Anzahl gleichzeitig von einer Aufgabe aufgezeichneter Dateien.

Definition

#define RECORD_FILE_NUM_MAX 2

2.3.5 RKADK_REC_EVENT_CALLBACK_FN

Beschreibung

Zeiger auf den Aufzeichnungsereignis-Callback.

Definition

typedef RKADK_MUXER_EVENT_CALLBACK_FN RKADK_REC_EVENT_CALLBACK_FN;

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_EVENT_CALLBACK_FN

2.3.6 RKADK_REC_TYPE_E

Beschreibung

Aufzählung der Aufzeichnungstypen.

Definition

typedef RKADK_MUXER_REC_TYPE_E RKADK_REC_TYPE_E;

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_REC_TYPE_E

2.3.7 RKADK_REC_REQUEST_FILE_NAMES_FN

Beschreibung

Zeiger auf die Funktion zum Anfordern eines Videodateinamens.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_MW_PTR RKADK_RECORD_ATTR_S

2.3.8 RKADK_REC_PTS_CALLBACK_FN

Beschreibung

Zeiger auf den Callback für Videoframe-Zeitstempel.

Definition

typedef RKADK_MUXER_PTS_CALLBACK_FN RKADK_REC_PTS_CALLBACK_FN;

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_PTS_CALLBACK_FN RKADK_RECORD_ATTR_S

2.3.9 RKADK_MOUNT_SDCARD_FN

Beschreibung

Zeiger auf die Funktion zum Einhängen der SD-Karte.

Definition

typedef int (*RKADK_MOUNT_SDCARD_FN)(void);

Verwandte Datentypen und Schnittstellen

RKADK_RECORD_ATTR_S

2.3.10 RKADK_RECORD_ATTR_S

Beschreibung

Attributstruktur der Aufzeichnungsaufgabe.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

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

Beschreibung

Attributstruktur der manuellen Aufteilung.

Definition

typedef MUXER_MANUAL_SPLIT_ATTR_S RKADK_REC_MANUAL_SPLIT_ATTR_S;

Verwandte Datentypen und Schnittstellen

MUXER_MANUAL_SPLIT_ATTR_S RKADK_RECORD_ManualSplit

2.3.12 FILE_CACHE_ARG

Beschreibung

Attributstruktur von File Cache.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_RECORD_FileCacheInit FILE_WRITE_THREAD_ARG FILE_SDCARD_ARG

2.3.13 FILE_WRITE_THREAD_ARG

Beschreibung

Attributstruktur des Schreibthreads.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_RECORD_FileCacheInit

FILE_CACHE_ARG

2.3.14 FILE_SDCARD_ARG

Beschreibung

Attributstruktur der SD-Karte.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

FILE_CACHE_ARG

2.3.15 RKADK_POST_ISP_ATTR_S

Beschreibung

Attributstruktur von Post AI ISP.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MEDIA_EnablePostIsp RKADK_MEDIA_SetPostIspAttr

2.3.16 RKADK_AOV_ATTR_S

Beschreibung

Attributstruktur von AOV.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_RECORD_Create

2.3.17 RKADK_PIP_ATTR_S

Beschreibung

Attributstruktur für Bild-in-Bild.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_RECORD_Create RKADK_RECORD_SetPipAttr

3. Muxer

Das Modul bietet Erstellen, Zerstören, Starten und Stoppen von Muxern sowie manuelle Dateiaufteilung. Jeder Muxer verpackt gleichzeitig bis zu zwei Dateien. Jede Datei enthält mindestens einen Videostream und höchstens einen Video- und einen Audiostream. Mehrere Muxer können gleichzeitig erstellt werden. Streams von Drittanbietern werden unterstützt.

3.1 API-Referenz

3.1.1 RKADK_MUXER_Create

Beschreibung

Muxer erstellen.

Syntax

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

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Wiederholtes Erstellen desselben Muxers wird nicht unterstützt. Nach dem Erstellen zunächst RKADK_MUXER_Enable zum Aktivieren, dann RKADK_MUXER_Start zum Starten aufrufen.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Destroy.

3.1.2 RKADK_MUXER_Destroy

Beschreibung

Muxer zerstören.

Syntax

RKADK_S32 RKADK_MUXER_Destroy(RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Nur erstellte Muxer können zerstört werden; wiederholtes Zerstören wird nicht unterstützt. Vorher mit RKADK_MUXER_Stop stoppen und anschließend mit RKADK_MUXER_Disable deaktivieren.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Create

3.1.3 RKADK_MUXER_Enable

Beschreibung

Muxer aktivieren.

Syntax

RKADK_S32 RKADK_MUXER_Enable(RKADK_MUXER_ATTR_S *pstMuxerAttr, RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Zusammen mit RKADK_MUXER_Disable verwenden.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Disable.

3.1.4 RKADK_MUXER_Disable

Beschreibung

Muxer deaktivieren.

Syntax

RKADK_S32 RKADK_MUXER_Disable(RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Zusammen mit RKADK_MUXER_Enable verwenden.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Enable

3.1.5 RKADK_MUXER_Start

Beschreibung

Muxer initialisieren.

Syntax

RKADK_S32 RKADK_MUXER_Start(RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Ein gestoppter Muxer kann erneut gestartet werden.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Stop

3.1.6 RKADK_MUXER_Stop

Beschreibung

Muxer stoppen.

Syntax

RKADK_S32 RKADK_MUXER_Stop(RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Wiederholtes Stoppen desselben Muxers wird nicht unterstützt.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Start

3.1.7 RKADK_MUXER_Single_Start

Beschreibung

Muxer des angegebenen Streams starten.

Syntax

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

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Zusammen mit RKADK_MUXER_Single_Stop verwenden. Ein erneuter Start nach dem Stoppen wird unterstützt.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Single_Stop

3.1.8 RKADK_MUXER_Single_Stop

Beschreibung

Muxer des angegebenen Streams stoppen.

Syntax

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

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Zusammen mit RKADK_MUXER_Single_Start verwenden. Wiederholtes Stoppen desselben Muxers wird nicht unterstützt.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Single_Start

3.1.9 RKADK_MUXER_ManualSplit

Beschreibung

Dateien manuell aufteilen.

Syntax

RKADK_S32 RKADK_MUXER_ManualSplit(RKADK_MW_PTR pHandle, RKADK_MUXER_MANUAL_SPLIT_ATTR_S *pstSplitAttr);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Erneutes manuelles Aufteilen vor Abschluss der vorherigen Aufteilung wird unterstützt.

Beispiel

rkadk_muxer_test

3.1.10 RKADK_MUXER_Reset

Beschreibung

Muxer zurücksetzen.

Syntax

RKADK_S32 RKADK_MUXER_Reset(RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librokadk.so.

Hinweise

Vor RKADK_MUXER_Reset den Muxer mit RKADK_MUXER_SetResetState in den Reset-Zustand versetzen. Danach mit RKADK_MUXER_ResetParam die Parameter neu konfigurieren und anschließend mit RKADK_MUXER_SetResetState den Reset-Zustand wieder verlassen.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_ResetParam RKADK_MUXER_SetResetState

3.1.11 RKADK_MUXER_ResetParam

Beschreibung

Muxer-Parameter neu konfigurieren.

Syntax

RKADK_S32 RKADK_MUXER_ResetParam(RKADK_MUXER_ATTR_S *pstMuxerAttr, RKADK_MW_PTR pHandle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Reset RKADK_MUXER_SetResetState

3.1.12 RKADK_MUXER_SetResetState

Beschreibung

Reset-Zustand des Muxers setzen.

Syntax

void RKADK_MUXER_SetResetState(RKADK_MW_PTR pHandle, bool state);

Parameter

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Beispiel

rkadk_muxer_test.

Verwandte Themen

RKADK_MUXER_Reset RKADK_MUXER_ResetParam

3.1.13 RKADK_MUXER_BuildInThumb

Beschreibung

Vorschaubilder in Dateien einbetten.

Syntax

RKADK_S32 RKADK_MUXER_BuildInThumb(RKADK_MW_PTR pHandle, RKADK_MUXER_THUMB_INFO_S stThumbInfo);

Parameter

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Hinweise

Zum Einbetten von Vorschaubildern bei RKADK_MUXER_Create deren Auflösung korrekt einstellen, damit Speicherplatz reserviert wird. Nur MP4-Dateien unterstützen eingebettete Vorschaubilder.

Beispiel

rkadk_muxer_test.

3.1.14 RKADK_MUXER_WriteVideoFrame

Beschreibung

Videostreamdaten schreiben.

Syntax

int RKADK_MUXER_WriteVideoFrame(RKADK_MUXER_DATA_S stData, void *handle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Beispiel

rkadk_muxer_test.

3.1.15 RKADK_MUXER_WriteAudioFrame

Beschreibung

Audiostreamdaten schreiben.

Syntax

int RKADK_MUXER_WriteAudioFrame(RKADK_MUXER_DATA_S stData, void *handle);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_muxer.h. Bibliothek: librkadk.so.

Beispiel

rkadk_muxer_test.

3.2 Datentypen

Wichtige Muxer-Datentypen: RKADK_MUXER_FILE_TYPE_E - Dateitypen; RKADK_MUXER_EVENT_E - Ereignisse; RKADK_MUXER_FILE_EVENT_INFO_S - Dateiereignisinformationen; RKADK_MUXER_EVENT_INFO_S - Muxer-Ereignisinformationen; RKADK_MUXER_EVENT_CALLBACK_FN - Ereignis-Callback; RKADK_MUXER_MANUAL_SPLIT_ATTR_S - Attribute der manuellen Aufteilung; RKADK_MUXER_MANUAL_SPLIT_TYPE_E - Arten der manuellen Aufteilung; RKADK_MUXER_ATTR_S - Muxer-Attribute; RKADK_MUXER_REC_TYPE_E - Aufzeichnungstypen; RKADK_MUXER_TYPE_E - Muxer-Typen; RKADK_MUXER_REQUEST_FILE_NAME_CB - Dateinamenanforderung; RKADK_MUXER_STREAM_ATTR_S - Streamattribute; RKADK_MUXER_PRE_RECORD_ATTR_S - Voraufzeichnungsattribute; RKADK_MUXER_PRE_RECORD_MODE_E - Voraufzeichnungsmodi; RKADK_MUXER_PTS_CALLBACK_FN - Zeitstempel-Callback; RKADK_MUXER_PTS_INFO_S - Zeitstempelinformationen; RKADK_MUXER_DATA_S - Verpackungsdaten; RKADK_MUXER_THUMB_INFO_S - Vorschaubildinformationen; RKADK_THIRD_MUXER_ATTR_S - Attribute eines Drittanbieter-Muxers.

3.2.1 RKADK_MUXER_FILE_TYPE_E

Beschreibung

Aufzählung der Muxer-Dateitypen.

Definition

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;

Member

Hinweise

Nur MP4-Dateien unterstützen eingebettete Vorschaubilder.

3.2.2 RKADK_MUXER_EVENT_E

Beschreibung

Aufzählung der Muxer-Ereignisse.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_EVENT_INFO_S

3.2.3 RKADK_MUXER_FILE_EVENT_INFO_S

Beschreibung

Struktur der Dateiereignisinformationen.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_EVENT_INFO_S

3.2.4 RKADK_MUXER_EVENT_INFO_S

Beschreibung

Struktur der Muxer-Ereignisinformationen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_EVENT_E RKADK_MUXER_FILE_EVENT_INFO_S

3.2.5 RKADK_MUXER_EVENT_CALLBACK_FN

Beschreibung

Zeiger auf den Muxer-Ereignis-Callback.

Definition

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

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_EVENT_INFO_S

3.2.6 RKADK_REC_MANUAL_SPLIT_ATTR_S

Beschreibung

Attributstruktur der manuellen Aufteilung.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_MANUAL_SPLIT_TYPE_E RKADK_MUXER_ManualSplit

3.2.7 RKADK_MUXER_MANUAL_SPLIT_TYPE_E

Beschreibung

Art der manuellen Aufteilung.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_REC_MANUAL_SPLIT_ATTR_S

3.2.8 RKADK_THIRD_MUXER_ATTR_S

Beschreibung

Attributstruktur eines Drittanbieter-Muxers.

Definition

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;

Member

Hinweise

Bei aktiviertem Drittanbieter-Muxer wird das Abrufen von Videovorschaubildern über RKADK_GetthmInMp4 und RKADK_GetthmInMp4Ex nicht unterstützt.

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_ATTR_S

3.2.9 RKADK_MUXER_ATTR_S

Beschreibung

Attributstruktur des Muxers.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

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

Beschreibung

Aufzählung der Muxer-Aufzeichnungstypen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

Keine. Hinweis: Nur RV1126, RV1106 und RV1126B unterstützen AOV-Zeitrafferaufzeichnung.

3.2.11 RKADK_MUXER_TYPE_E

Beschreibung

Aufzählung der Muxer-Typen.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_ATTR_S

3.2.12 RKADK_MUXER_REQUEST_FILE_NAME_CB

Beschreibung

Zeiger auf den Callback zur Dateinamenanforderung.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_ATTR_S

3.2.13 RKADK_MUXER_PTS_CALLBACK_FN

Beschreibung

Zeiger auf den Callback für Videoframe-Zeitstempel.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_PTS_INFO_S RKADK_MUXER_ATTR_S

3.2.14 RKADK_MUXER_PTS_INFO_S

Beschreibung

Struktur der Zeitstempelinformationen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_PTS_CALLBACK_FN

3.2.15 RKADK_MUXER_STREAM_ATTR_S

Beschreibung

Attributstruktur des Muxer-Streams.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_TRACK_SOURCE_S RKADK_MUXER_FILE_TYPE_E

3.2.16 RKADK_MUXER_TRACK_SOURCE_S

Beschreibung

Attributstruktur des Muxer-Streams.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

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

Beschreibung

Aufzählung der Muxer-Streamspurtypen.

Definition

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

Member

3.2.18 RKADK_TRACK_VIDEO_SOURCE_INFO_S

Beschreibung

Attributstruktur des Muxer-Videostreams.

Definition

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;

Member

3.2.19 RKADK_TRACK_AUDIO_SOURCE_INFO_S

Beschreibung

Attributstruktur des Muxer-Audiostreams.

Definition

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;

Member

3.2.20 RKADK_MUXER_PRE_RECORD_ATTR_S

Beschreibung

Attributstruktur der Voraufzeichnung.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_PRE_RECORD_MODE_E RKADK_MUXER_ATTR_S

Hinweise

u32PreRecCacheTime muss mindestens u32PreRecTimeSec betragen und eine vollständige GoP enthalten, damit der I-Frame korrekt abgerufen werden kann.

3.2.21 RKADK_MUXER_PRE_RECORD_MODE_E

Beschreibung

Aufzählung der Voraufzeichnungsmodi.

Definition

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;

Member

3.2.22 RKADK_MUXER_DATA_S

Beschreibung

Datenstruktur des Muxers.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_WriteVideoFrame RKADK_MUXER_WriteAudioFrame

3.2.23 RKADK_MUXER_THUMB_INFO_S

Beschreibung

Struktur der Vorschaubildinformationen.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_MUXER_BuildInThumb

4. AOV (kontinuierliche Videoaufzeichnung)

4.1 Überblick

AOV (Always On Video) zeichnet durch Schlaf-/Aufwachzyklen kontinuierlich mit niedriger Framerate auf. Ereignisse wie KI-Erkennung, PIR-Auslösung oder WLAN-Aufwecken können zur normalen Framerate zurückschalten. File Cache wird empfohlen; siehe RKADK_RECORD_FileCacheInit und RKADK_RECORD_FileCacheDeInit im Aufzeichnungskapitel. Um im AOV-Zeitraffermodus Energie zu sparen, wird die SD-Karte im Schlaf stromlos geschaltet; die Anwendung muss sie zuvor aushängen. Bei aktiviertem File Cache versucht dieser beim Schreiben die Karte einzuhängen und schützt den Schreibvorgang vor einem zwischenzeitlichen Aushängen. Der AOV-Ablauf ist unten dargestellt.

4.2 API-Referenz

4.2.1 RKADK_AOV_Init

Beschreibung

AOV initialisieren.

Syntax

int RKADK_AOV_Init(RKADK_AOV_ARG_S *pstAovAttr);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_aov.h. Bibliothek: librkadk.so.

Hinweis

Zusammen mit RKADK_AOV_DeInit verwenden. Wiederholte Initialisierung wird nicht unterstützt.

Beispiel

rkadk_aov_record_test

Verwandtes Thema

RKADK_AOV_DeInit

4.2.2 RKADK_AOV_DeInit

Beschreibung

AOV deinitialisieren.

Syntax

int RKADK_AOV_DeInit();

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_aov.h. Bibliothek: librkadk.so.

Hinweis

Zusammen mit RKADK_AOV_Init verwenden. Wiederholte Deinitialisierung wird nicht unterstützt.

Beispiel

rkadk_aov_record_test

Verwandtes Thema

RKADK_AOV_Init

4.2.3 RKADK_AOV_SetSuspendTime

Beschreibung

Geplante AOV-Schlafdauer in ms einstellen.

Syntax

int RKADK_AOV_SetSuspendTime(int u32WakeupSuspendTime);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_aov.h. Bibliothek: librkadk.so.

Beispiel

rkadk_aov_record_test

4.2.4 RKADK_AOV_EnterSleep

Beschreibung

In AOV wechseln.

Syntax

int RKADK_AOV_EnterSleep();

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_aov.h. Bibliothek: librkadk.so.

Beispiel

rkadk_aov_record_test

4.2.5 RKADK_AOV_WakeupLock

Beschreibung

AOV-Operationen sperren.

Syntax

void RKADK_AOV_WakeupLock();

Voraussetzungen

Headerdatei: rkadk_aov.h. Bibliothek: librkadk.so.

Hinweis

Zusammen mit RKADK_AOV_WakeupUnlock verwenden.

Beispiel

rkadk_aov_record_test

Verwandtes Thema

RKADK_AOV_WakeupUnlock

4.2.6 RKADK_AOV_WakeupUnlock

Beschreibung

AOV-Operationen entsperren.

Syntax

void RKADK_AOV_WakeupUnlock();

Voraussetzungen

Headerdatei: rkadk_aov.h. Bibliothek: librkadk.so.

Hinweis

Zusammen mit RKADK_AOV_WakeupLock verwenden.

Beispiel

rkadk_aov_record_test

Verwandtes Thema

RKADK_AOV_WakeupLock

4.3 Datentypen

Wichtige AOV-Datentypen: RKADK_AOV_ARG_S - AOV-Attributstruktur; RKADK_AOV_NOTIFY_CALLBACK - Zeiger auf den AOV-Benachrichtigungs-Callback.

4.3.1 RKADK_AOV_ARG_S

Definition

Attributstruktur von AOV.

Definition

typedef struct {
   RKADK_AOV_NOTIFY_CALLBACK pfnNotifyCallback;
} RKADK_AOV_ARG_S;

Member

Verwandte Datentypen und Schnittstellen: RKADK_AOV_Init, RKADK_AOV_NOTIFY_CALLBACK

4.3.2 RKADK_AOV_NOTIFY_CALLBACK

Definition

Zeiger auf den AOV-Benachrichtigungs-Callback.

Definition

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

Member

Verwandte Datentypen und Schnittstellen: RKADK_AOV_ARG_S, RKADK_AOV_EVENT_E

4.3.3 RKADK_AOV_EVENT_E

Definition

Aufzählung der AOV-Benachrichtigungsereignisse.

Definition

typedef enum {
   RKADK_AOV_ENTER_SLEEP = 0,
   RKADK_AOV_EVENT_BUTT
} RKADK_AOV_EVENT_E;

Member

Verwandte Datentypen und Schnittstellen

RKADK_AOV_NOTIFY_CALLBACK

5. Fotoaufnahme

5.1 Überblick

Grundlegende Fotoaufnahme mit JPEG-Kapselung: Einzelaufnahmen, Serienaufnahmen und JPEG Slice. JPEG Slice kodiert VI-Daten abschnittsweise in JPEG und spart Speicher. Beim Vergrößern werden die VI-Daten abschnittsweise interpoliert und anschließend abschnittsweise in JPEG kodiert. Die Segmenthöhe muss auf 16 Pixel ausgerichtet sein. Für gute Zusammensetzung sollte das Seitenverhältnis der Segmente möglichst dem Originalbild entsprechen. Mehr Segmente sparen Speicher, verlängern aber die Bilderzeugung; weniger Segmente benötigen mehr Speicher, beschleunigen jedoch die Verarbeitung. Die Segmentanzahl richtet sich nach dem konkreten Einsatz.

5.2 API-Referenz

5.2.1 RKADK_PHOTO_Init

Beschreibung

Fotoaufnahmeaufgabe initialisieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Hinweis

Wiederholte Initialisierung wird nicht unterstützt.

Beispiel

rkadk_photo_test

Siehe auch

RKADK_PHOTO_DeInit

5.2.2 RKADK_PHOTO_DeInit

Beschreibung

Fotoaufnahmeaufgabe deinitialisieren.

Syntax

RKADK_S32 RKADK_PHOTO_DeInit(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Hinweis

Wiederholte Deinitialisierung wird nicht unterstützt.

Beispiel

rkadk_photo_test

Siehe auch

RKADK_PHOTO_DeInit

5.2.3 RKADK_PHOTO_TakePhoto

Beschreibung

Fotos aufnehmen.

Syntax

RKADK_S32 RKADK_PHOTO_TakePhoto(RKADK_MW_PTR pHandle, RKADK_TAKE_PHOTO_ATTR_S *pstAttr);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PHOTO_TakePhoto darf erst nach Initialisierung der Aufzeichnungsaufgabe verwendet werden (Wortlaut der Quelle).

Beispiel

rkadk_photo_test

Siehe auch

Nein

5.2.4 RKADK_PHOTO_Reset

Beschreibung

Fotoaufnahmeaufgabe neu konfigurieren.

Syntax

RKADK_S32 RKADK_PHOTO_Reset(RKADK_MW_PTR *ppHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PHOTO_Reset darf erst nach Initialisierung der Aufzeichnungsaufgabe verwendet werden (Quellbezeichnung). Beim Auflösungswechsel die Photo-Auflösung in der ini über RKADK_PARAM_SetCamParam ändern. RV1126/RV1109 und RK3576 unterstützen keinen dynamischen Auflösungswechsel: zuerst RKADK_PHOTO_DeInit, dann neue Auflösung einstellen und RKADK_PHOTO_Init aufrufen. Bei gemeinsam genutztem VI-Kanal die Auflösungen von Photo und den anderen Modulen gleichzeitig umstellen, damit VI und VENC übereinstimmen.

Beispiel

rkadk_photo_test

Siehe auch

5.2.5 RKADK_PHOTO_GetThmInJpg

Beschreibung

Vorschaubilddaten aus einer JPG-Datei abrufen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Beispiel

rkadk_thumb_test

Siehe auch

No.

5.2.6 RKADK_PHOTO_GetThmInJpgEx

Beschreibung

Die erweiterte Schnittstelle zum Abrufen von JPG-Vorschaubildern unterstützt die Angabe von Typ und Auflösung. Zusammen mit RKADK_PHOTO_ThumbBufFree verwenden.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Beispiel

rkadk_thumb_test

Siehe auch

RKADK_PHOTO_ThumbBufFree

5.2.7 RKADK_PHOTO_ThumbBufFree

Beschreibung

Von RKADK_PHOTO_GetThmInJpgEx angeforderten Speicher freigeben. Zusammen mit RKADK_PHOTO_GetThmInJpgEx verwenden.

Syntax

RKADK_S32 RKADK_PHOTO_ThumbBufFree(RKADK_THUMB_ATTR_S *pstThumbAttr);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_photo.h. Bibliothek: librkadk.so.

Beispiel

rkadk_thumb_test

Siehe auch

RKADK_PHOTO_GetThmInJpgEx

5.2.8 RKADK_MEDIA_SetVencRotation

Beschreibung

Drehung des VENC-Kanals einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_media_comm.h. Bibliothek: librkadk.so.

5.2.9 RKADK_MEDIA_ToggleVencMirror

Beschreibung

Spiegelung des VENC-Kanals einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_media_comm.h. Bibliothek: librkadk.so.

5.2.10 RKADK_MEDIA_ToggleVencFlip

Beschreibung

Vertikales Spiegeln des VENC-Kanals einstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_media_comm.h. Bibliothek: librkadk.so.

5.3 Datentypen

Wichtige Foto-Datentypen: RKADK_PHOTO_TYPE_E - Aufnahmetypen; RKADK_PHOTO_SINGLE_ATTR_S - Einzelaufnahmeattribute; RKADK_PHOTO_MULTIPLE_ATTR_S - Serienaufnahmeattribute; RKADK_PHOTO_RECV_DATA_S - Fotodaten; RKADK_PHOTO_DATA_RECV_FN_PTR - Datenempfangsfunktion; RKADK_TAKE_PHOTO_ATTR_S - Aufnahmeattribute; RKADK_PHOTO_ATTR_S - Aufgabenattribute; RKADK_JPG_THUMB_TYPE_E - JPG-Vorschaubildtypen; RKADK_THUMB_TYPE_E - Ausgabevorschaubildtypen; RKADK_THUMB_ATTR_S - Vorschaubildattribute; ROTATION_E - Drehungstypen; RKADK_PHOTO_FMT_CHANGE_S - Parameter zur FBC0/NV16-Konvertierung.

5.3.1 RKADK_PHOTO_TYPE_E

Beschreibung

Aufzählung der Fotoaufnahmetypen.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_TAKE_PHOTO_ATTR_S

5.3.2 RKADK_PHOTO_SINGLE_ATTR_S

Beschreibung

Attributstruktur der Einzelaufnahme.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_TAKE_PHOTO_ATTR_S

5.3.3 RKADK_PHOTO_MULTIPLE_ATTR_S

Beschreibung

Attributstruktur der Serienaufnahme.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_TAKE_PHOTO_ATTR_SS

5.3.4 RKADK_PHOTO_THUMB_ATTR_S

Beschreibung

Parameterstruktur des Vorschaubildes.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PHOTO_ATTR_S

5.3.5 RKADK_PHOTO_RECV_DATA_S

Beschreibung

Struktur der Fotodaten.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PHOTO_DATA_RECV_FN_PTR

5.3.6 RKADK_PHOTO_DATA_RECV_FN_PTR

Beschreibung

Zeiger auf die Fotodaten-Empfangsfunktion.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PHOTO_RECV_DATA_S RKADK_PHOTO_ATTR_S

5.3.7 RKADK_TAKE_PHOTO_ATTR_S

Beschreibung

Attributstruktur der Fotoaufnahme.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

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

Beschreibung

Parameterstruktur für die FBC0/NV16-Formatkonvertierung

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PHOTO_ATTR_S RKADK_PHOTO_Init

5.3.9 RKADK_PHOTO_ATTR_S

Beschreibung

Attributstruktur der Fotoaufnahmeaufgabe.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

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

Beschreibung

Aufzählung der JPG-Vorschaubildtypen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PHOTO_GetThmInJpg RKADK_PHOTO_GetThmInJpgEx

5.3.11 RKADK_THUMB_TYPE_E

Beschreibung

Aufzählung der Ausgabevorschaubildtypen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_THUMB_ATTR_S RKADK_GetThmInMp4Ex RKADK_PHOTO_GetThmInJpgEx

5.3.12 RKADK_THUMB_ATTR_S

Beschreibung

Attributstruktur des Vorschaubildes.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_THUMB_TYPE_E

RKADK_GetThmInMp4Ex RKADK_PHOTO_GetThmInJpgEx

5.3.13 ROTATION_E

Beschreibung

Aufzählung der Drehungstypen.

Definition

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

Verwandte Datentypen und Schnittstellen

RKADK_MEDIA_SetVencRotation

6. Remote-Vorschau

6.1 Überblick

Callback-Schnittstellen für die Vorschau ermöglichen das Abrufen von Video-/Audioinformationen, Starten und Stoppen von VENC/AENC sowie Registrieren von Verarbeitungsfunktionen für Audio- und Videoframes.

6.2 API-Referenz

6.2.1 RKADK_STREAM_VideoInit

Beschreibung

Videomodule VI und VENC initialisieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Wiederholte Initialisierung des Videomoduls wird nicht unterstützt.

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_VideoDeInit

6.2.2 RKADK_STREAM_VideoDeInit

Beschreibung

Videomodule VI und VENC deinitialisieren.

Syntax

RKADK_S32 RKADK_STREAM_VideoDeInit(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Wiederholte Deinitialisierung wird nicht unterstützt.

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_VideoInit

6.2.3 RKADK_STREAM_VencStart

Beschreibung

VENC aktivieren.

Syntax

RKADK_S32 RKADK_STREAM_VencStart(RKADK_MW_PTR pHandle, RKADK_S32 s32FrameCnt);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

RKADK_STREAM_VencStart darf erst nach Initialisierung des Videomoduls aufgerufen werden. Der Aufruf löst den VENC-Daten-Callback zum Start des Empfangs aus.

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_VencStop

6.2.4 RKADK_STREAM_VencStop

Beschreibung

VENC deaktivieren.

Syntax

RKADK_S32 RKADK_STREAM_VencStop(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_VencStart

6.2.5 RKADK_STREAM_VideoReset

Beschreibung

Videostream neu konfigurieren.

Syntax

RKADK_S32 RKADK_STREAM_VideoReset(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

RKADK_STREAM_VideoReset darf erst nach RKADK_STREAM_VideoInit aufgerufen werden. Bei Änderung von Auflösung, Framerate, Bitrate, Kodierungs- oder Aufzeichnungstyp die Preview-Parameter in der ini über RKADK_PARAM_SetCamParam anpassen. RV1126/RV1109 und RK3576 unterstützen keinen dynamischen Wechsel von Auflösung und Kodierungstyp: zuerst RKADK_STREAM_VideoDeInit, dann neue Parameter und RKADK_STREAM_VideoInit. Bei gemeinsam genutztem VI-Kanal alle betroffenen Auflösungen gleichzeitig umstellen, damit VI und VENC übereinstimmen.

Beispiel

rkadk_stream_test

6.2.6 RKADK_STREAM_GetVideoInfo

Beschreibung

Videoinformationen abrufen.

Syntax

RKADK_S32 RKADK_STREAM_GetVideoInfo(RKADK_U32 u32CamId, RKADK_VIDEO_INFO_S *pstVideoInfo);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_stream_test

Siehe auch

Keine

6.2.7 RKADK_STREAM_AudioInit

Beschreibung

Audiomodule AI und AENC initialisieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Wiederholte Initialisierung des Audiomoduls wird nicht unterstützt.

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_AudioDeInit

6.2.8 RKADK_STREAM_AudioDeInit

Beschreibung

Audiomodule AI und AENC deinitialisieren.

Syntax

RKADK_S32 RKADK_STREAM_AudioDeInit(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_AudioInit

6.2.9 RKADK_STREAM_AencStart

Beschreibung

AENC aktivieren.

Syntax

RKADK_S32 RKADK_STREAM_AencStart(RKADK_MW_PTR *pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

RKADK_STREAM_AencStart darf erst nach Initialisierung des Audiomoduls aufgerufen werden. Der Aufruf löst den AENC-Daten-Callback zum Start des Empfangs aus.

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_AencStop

6.2.10 RKADK_STREAM_AencStop

Beschreibung

AENC deaktivieren.

Syntax

RKADK_S32 RKADK_STREAM_AencStop(RKADK_MW_PTR *pHandle);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_stream_test

Siehe auch

RKADK_STREAM_AencStart

6.2.11 RKADK_STREAM_GetAudioInfo

Beschreibung

Audioinformationen abrufen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_stream.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_stream_test

Siehe auch

Keine

6.3 Datentypen

Die Quelle nennt folgende Typen des Wiedergabemoduls: RKADK_CODEC_TYPE_E - Kodierungsformate; RKADK_VENC_DATA_PROC_FUNC - VENC-Daten-Callback; RKADK_VIDEO_STREAM_S - Videostream; RKADK_VENC_DATA_PACK_S - VENC-Paket; RKADK_VENC_DATA_TYPE_S - VENC-Pakettyp; RKADK_VIDEO_INFO_S - Videoinformationen; RKADK_STREAM_VIDEO_ATTR_S - Videoaufgabenattribute; RKADK_AUDIO_DATA_PROC_FUNC - Audiodaten-Callback; RKADK_AUDIO_STREAM_S - Audiodaten; RKADK_AUDIO_INFO_S - Audioinformationen; RKADK_STREAM_AUDIO_ATTR_S - Audioaufgabenattribute.

6.3.1 RKADK_CODEC_TYPE_E

Beschreibung

Aufzählung der Kodierungsformate. AAC-Audiokodierung wird standardmäßig nicht unterstützt.

Definition

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

Beschreibung

Zeiger auf den VENC-Daten-Callback.

Definition

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

Verwandte Datentypen und Schnittstellen

RKADK_VIDEO_STREAM_S

6.3.3 RKADK_VIDEO_STREAM_S

Beschreibung

Struktur des Videostreams.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_VENC_DATA_PACK_S RKADK_VENC_DATA_PROC_FUNC

6.3.4 RKADK_VENC_DATA_PACK_S

Beschreibung

Struktur des VENC-Pakets.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_VENC_DATA_TYPE_S RKADK_VIDEO_STREAM_S

6.3.5 RKADK_VENC_DATA_TYPE_S

Beschreibung

VENC-Pakettyp.

Definition

/* 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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_CODEC_TYPE_E RKADK_VENC_DATA_PACK_S

6.3.6 RKADK_VIDEO_INFO_S

Beschreibung

Struktur der Videoinformationen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_CODEC_TYPE_E RKADK_STREAM_GetVideoInfo

6.3.7 RKADK_STREAM_VIDEO_ATTR_S

Beschreibung

Attributstruktur der Videoaufgabe.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_VENC_DATA_PROC_FUNC RKADK_STREAM_VideoInit

6.3.8 RKADK_AUDIO_DATA_PROC_FUNC

Beschreibung

Zeiger auf den AENC-Daten-Callback.

Definition

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

Verwandte Datentypen und Schnittstellen

RKADK_AUDIO_STREAM_S

6.3.9 RKADK_AUDIO_STREAM_S

Beschreibung

Struktur des Audiodatenstroms.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_AUDIO_DATA_PROC_FUNC

6.3.10 RKADK_AUDIO_INFO_S

Beschreibung

Struktur der Audioinformationen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_CODEC_TYPE_E RKADK_STREAM_GetAudioInfo

6.3.11 RKADK_STREAM_AUDIO_ATTR_S

Beschreibung

Attributstruktur der Audioaufgabe.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_AUDIO_DATA_PROC_FUNC RKADK_STREAM_AudioInit

7. Player

7.1 Überblick

Wiedergabe lokaler Audio-/Videodateien und von RTSP-Netzwerkstreams mit Wiedergabe, Pause, Suche und Bildschirmaufnahme. Player ist mit RV1109/RV1126, RV1103/RV1103, RK3308 und RK3506 kompatibel (Quellliste unverändert). RV1109/RV1126 verwenden Hardwaredekodierung, die anderen Plattformen Softwaredekodierung.

7.2 API-Referenz

7.2.1 RKADK_PLAYER_Create

Beschreibung

Player erstellen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Wiederholtes Erstellen desselben Players wird nicht unterstützt.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_Destroy

7.2.2 RKADK_PLAYER_Destroy

Beschreibung

Player zerstören.

Syntax

RKADK_S32 RKADK_PLAYER_Destroy(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Das wiederholte Zerstören desselben Players wird nicht unterstützt.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_Create

7.2.3 RKADK_PLAYER_SetDataSource

Beschreibung

Pfad der wiederzugebenden Datei festlegen. Bei aktivierter externer Demuxer-Bibliothek in Player ist RKADK_PLAYER_SetDataParam zu verwenden.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PLAYER_SetDataSource darf erst nach dem Erstellen des Players aufgerufen werden.

Beispiel

rkadk_player_test

Siehe auch

Keine

7.2.4 RKADK_PLAYER_SetDataParam

Beschreibung

Audio- und Videoparameter der wiederzugebenden Datei festlegen. Diese Schnittstelle bei aktivierter externer Demuxer-Bibliothek verwenden, andernfalls RKADK_PLAYER_SetDataSource.

Syntax

RKADK_S32 RKADK_PLAYER_SetDataParam(RKADK_MW_PTR pPlayer, RKADK_PLAYER_DATA_PARAM_S *pstDataParam);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PLAYER_SetDataParam darf erst nach dem Erstellen des Players aufgerufen werden.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_SendAudioPacket RKADK_PLAYER_SendVideoPacket

7.2.5 RKADK_PLAYER_Prepare

Beschreibung

Wiedergabe vorbereiten.

Syntax

RKADK_S32 RKADK_PLAYER_Prepare(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PLAYER_Prepare darf erst nach dem Erstellen des Players und dem Festlegen des Wiedergabepfads aufgerufen werden.

Beispiel

rkadk_player_test

Siehe auch

Keine

7.2.6 RKADK_PLAYER_GetCurrentPosition

Beschreibung

Aktuelle Wiedergabeposition abrufen.

Syntax

RKADK_S64 RKADK_PLAYER_GetCurrentPosition(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_player.h

Bibliothek: librkadk.so

Hinweis

Keine

Beispiel

rkadk_player_test

Siehe auch

Keine

7.2.7 RKADK_PLAYER_Play

Beschreibung

Wiedergabe starten.

Syntax

RKADK_S32 RKADK_PLAYER_Play(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PLAYER_Play darf erst nach RKADK_PLAYER_Prepare aufgerufen werden.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_Stop

7.2.8 RKADK_PLAYER_Stop

Beschreibung

Wiedergabe stoppen und Ressourcen freigeben.

Syntax

RKADK_S32 RKADK_PLAYER_Stop(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_Play

7.2.9 RKADK_PLAYER_Pause

Beschreibung

Wiedergabe pausieren.

Syntax

RKADK_S32 RKADK_PLAYER_Pause(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_Play

7.2.10 RKADK_PLAYER_Seek

Beschreibung

Seek.

Syntax

RKADK_S32 RKADK_PLAYER_Seek(RKADK_MW_PTR pPlayer, RKADK_S64 s64TimeInMs);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

RKADK_PLAYER_Seek darf erst nach RKADK_PLAYER_Play aufgerufen werden.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_Play

7.2.11 RKADK_PLAYER_GetPlayStatus

Beschreibung

Aktuellen Wiedergabestatus abrufen.

Syntax

RKADK_S32 RKADK_PLAYER_GetPlayStatus(RKADK_MW_PTR pPlayer, RKADK_PLAYER_STATE_E *penState);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_player_test

Siehe auch

Keine

7.2.12 RKADK_PLAYER_GetDuration

Beschreibung

Dauer der aktuell wiedergegebenen Datei abrufen.

Syntax

RKADK_S32 RKADK_PLAYER_GetDuration(RKADK_MW_PTR pPlayer, RKADK_U32 *pDuration);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Keine

Beispiel

rkadk_player_test

Siehe auch

Keine

7.2.13 RKADK_PLAYER_Snapshot

Beschreibung

Player-Schnappschuss: Die Schnittstelle kodiert das aktuell angezeigte Bild als JPEG. Die Anwendung erhält die erzeugten JPEG-Daten über den registrierten Callback RKADK_PPLAYER_SNAPSHOT_RECV_FN.

Syntax

RKADK_S32 RKADK_PLAYER_Snapshot(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Beispiel

rkadk_player_test

Siehe auch

Keine

7.2.14 RKADK_PLAYER_SendAudioPacket

Beschreibung

Bei aktivierter externer Demuxer-Bibliothek übergibt diese Schnittstelle demultiplexte Audiodaten an Player zur Dekodierung und Wiedergabe.

Syntax

RKADK_S32 RKADK_PLAYER_SendAudioPacket(RKADK_MW_PTR pPlayer, RKADK_PLAYER_PACKET *pstPacket);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Vor Verwendung dieser Schnittstelle RKADK_PLAYER_SetDataParam aufrufen, um die Audio- und Videoparameter festzulegen.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_SendVideoPacket RKADK_PLAYER_SetDataParam

7.2.15 RKADK_PLAYER_SendVideoPacket

Beschreibung

Bei aktivierter externer Demuxer-Bibliothek übergibt diese Schnittstelle demultiplexte Videodaten an Player zur Dekodierung und Wiedergabe.

Syntax

RKADK_S32 RKADK_PLAYER_SendVideoPacket(RKADK_MW_PTR pPlayer, RKADK_PLAYER_PACKET *pstPacket);

Parameter

Rückgabewert

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweis

Vor Verwendung dieser Schnittstelle RKADK_PLAYER_SetDataParam aufrufen, um die Audio- und Videoparameter festzulegen.

Beispiel

rkadk_player_test

Siehe auch

RKADK_PLAYER_SendAudioPacket RKADK_PLAYER_SetDataParam

7.2.16 RKADK_PLAYER_GetSendFrameNum

Beschreibung

Anzahl erfolgreich dekodierter Frames abrufen.

Syntax

RKADK_S32 RKADK_PLAYER_GetSendFrameNum(RKADK_MW_PTR pPlayer);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_player.h

Bibliothek: librkadk.so. Hinweis: Nach Pause/Stop wird der Zähler zurückgesetzt.

Beispiel

rkadk_player_test

Verwandte Themen

Keine

7.2.17 RKADK_PLAYER_SetVdecWaterline

Beschreibung

VDEC-Pufferfüllstandsschwelle festlegen.

Syntax

RKADK_S32 RKADK_PLAYER_SetVdecWaterline(RKADK_MW_PTR pPlayer, RKADK_U32 u32VdecWaterline);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_player.h. Bibliothek: librkadk.so. Hinweis: Nach dem Einstellen der VDEC-Füllstandsschwelle beginnt die Wiedergabe erst, wenn der VDEC-Puffer diesen Füllstand erreicht.

Beispiel

rkadk_player_test

Verwandte Themen

Keine

7.2.18 RKADK_PLAYER_SetAoVolume

Beschreibung

Wiedergabelautstärke festlegen.

Syntax

RKADK_S32 RKADK_PLAYER_SetAoVolume(RKADK_MW_PTR pPlayer, RKADK_S32 s32Volume);

Parameter

Rückgabewerte

Voraussetzungen

Headerdatei: rkadk_player.h. Bibliothek: librkadk.so.

Hinweise

Keine

Beispiel

rkadk_player_test

Verwandte Themen

Keine

7.3 Datentypen

Das Wiedergabemodul stellt hauptsächlich folgende Datentypen bereit: RKADK_PLAYER_EVENT_E: Aufzählung der Wiedergabeereignisse; RKADK_PLAYER_EVENT_FN: Funktionszeiger auf den Callback für Wiedergabeereignisse.

RKADK_PLAYER_CFG_S: Player-Attributstruktur; RKADK_VO_FORMAT_E: Aufzählung der Pixelformate; RKADK_VO_INTF_TYPE_E: Aufzählung der Display-Schnittstellen; RKADK_PLAYER_FRAME_INFO_S: Bildinformationsstruktur; RKADK_PLAYER_STATE_E: Aufzählung der Wiedergabezustände; RKADK_PLAYER_DATA_PARAM_S: Audio-/Videoparameterstruktur; RKADK_PLAYER_PACKET: Player-Datenpaket; RKADK_PLAYER_RTSP_CFG_S: RTSP-Attributstruktur; RKADK_PLAYER_VDEC_CFG_S: VDEC-Attributstruktur; RKADK_PLAYER_SNAPSHOT_CFG_S: Schnappschuss-Attributstruktur; RKADK_PLAYER_SNAPSHOT_S: Schnappschuss-Datenstruktur; RKADK_PPLAYER_SNAPSHOT_RECV_FN: Funktionszeiger auf den Schnappschuss-Daten-Callback.

7.3.1 RKADK_PLAYER_EVENT_E

Beschreibung

Definiert die Aufzählung der Wiedergabeereignisse.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_EVENT_FN

7.3.2 RKADK_PLAYER_EVENT_FN

Beschreibung

Funktionszeiger auf den Wiedergabeereignis-Callback definieren.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_EVENT_E RKADK_PLAYER_CFG_S

7.3.3 RKADK_PLAYER_CFG_S

Beschreibung

Player-Attributstruktur definieren.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

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

Beschreibung

Definiert die Aufzählung der Bildpixelformate.

Definition

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;

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_FRAME_INFO_S

7.3.5 RKADK_VO_INTF_TYPE_E

Beschreibung

Definiert die Aufzählung der Display-Schnittstellen.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_FRAME_INFO_S

7.3.6 RKADK_VO_SPLICE_MODE_E

Beschreibung

Definiert die Aufzählung der Methoden zum Zusammenfügen von Ebenen.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_FRAME_INFO_S

7.3.7 RKADK_PLAYER_FRAME_INFO_S

Beschreibung

Bildinformationsstruktur definieren.

Definition

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;

Member

Hinweis

Details zu Videoausgabeattributen stehen im VO-Kapitel des Rockit-Dokuments Rockchip_Developer_Guide_MPI.pdf.

Verwandte Datentypen und Schnittstellen

RKADK_VO_FORMAT_E RKADK_VO_INTF_TYPE_E RKADK_VO_SPLICE_MODE_E

RKADK_PLAYER_Create

7.3.8 RKADK_PLAYER_STATE_E

Beschreibung

Definiert die Aufzählung der Wiedergabezustände.

Definition

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;

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_GetPlayStatus

7.3.9 RKADK_PLAYER_SNAPSHOT_S

Beschreibung

Schnappschuss-Datenstruktur definieren.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PPLAYER_SNAPSHOT_RECV_FN

7.3.10 RKADK_PPLAYER_SNAPSHOT_RECV_FN

Beschreibung

Definiert den Funktionszeiger auf den Schnappschuss-Daten-Callback.

Definition

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

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_SNAPSHOT_S RKADK_PLAYER_SNAPSHOT_CFG_S

7.3.11 RKADK_PLAYER_SNAPSHOT_CFG_S

Beschreibung

Schnappschuss-Attributstruktur definieren.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PPLAYER_SNAPSHOT_RECV_FN RKADK_PLAYER_CFG_S

7.3.12 RKADK_PLAYER_VDEC_CFG_S

Beschreibung

VDEC-Attributstruktur definieren.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_CFG_S

7.3.13 RKADK_PLAYER_RTSP_CFG_S

Beschreibung

RTSP-Attributstruktur definieren.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_CFG_S

7.3.14 RKADK_PLAYER_PACKET

Beschreibung

Datenpaketstruktur für die Nutzung der externen Demuxer-Bibliothek definieren.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_SendAudioPacket RKADK_PLAYER_SendVideoPacket

7.3.15 RKADK_PLAYER_DATA_PARAM_S

Beschreibung

Audio-/Videoparameterstruktur zur Verwendung mit aktivierter externer Demuxer-Bibliothek definieren.

Definition

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;

Member

Verwandte Datentypen und Schnittstellen

RKADK_PLAYER_SetDataParam

8. Live-Streaming

8.1 Überblick

Stellt grundlegende Dienste für standardmäßiges RTSP-Live-Streaming sowie RTMP-Live-Streaming bereit. RTSP und RTMP können nicht gleichzeitig gestartet werden.

8.2 API-Referenz

8.2.1 RTSP

8.2.1.1 RKADK_RTSP_Init

Beschreibung

RTSP-Modul initialisieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtsp.h

Bibliothek: librkadk.so

Hinweis

Nach RKADK_RTSP_Init RKADK_RTSP_Start aufrufen, um das RTSP-Live-Streaming zu starten.

Beispiel

rkadk_rtsp_test

Siehe auch

RKADK_RTSP_DeInit

8.2.1.2 RKADK_RTSP_DeInit

Beschreibung

RTSP-Modul deinitialisieren.

Syntax

RKADK_S32 RKADK_RTSP_DeInit(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtsp.h. Bibliothek: librkadk.so

Beispiel

rkadk_rtsp_test

Siehe auch

RKADK_RTSP_Init

8.2.1.3 RKADK_RTSP_Start

Beschreibung

RTSP-Live-Streaming starten.

Syntax

RKADK_S32 RKADK_RTSP_Start(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtsp.h. Bibliothek: librkadk.so

Hinweis

Diese Schnittstelle nach RKADK_RTSP_Init aufrufen.

Beispiel

rkadk_rtsp_test

Siehe auch

RKADK_RTSP_Stop

8.2.1.4 RKADK_RTSP_Stop

Beschreibung

RTSP-Live-Streaming stoppen.

Syntax

RKADK_S32 RKADK_RTSP_Stop(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtsp.h. Bibliothek: librkadk.so

Beispiel

rkadk_rtsp_test

Siehe auch

RKADK_RTSP_Start

8.2.1.5 RKADK_RTSP_VideoReset

Beschreibung

RTSP-Live-Streaming neu konfigurieren.

Syntax

RKADK_S32 RKADK_RTSP_VideoReset(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtsp.h

Bibliothek: librkadk.so

Hinweis

RKADK_RTSP_VideoReset ist erst nach RKADK_RTSP_Init verwendbar. Beim Ändern von Auflösung, Bildrate, Bitrate, Kodierungs- oder Aufzeichnungstyp die Live-Parameter in der ini-Datei über RKADK_PARAM_SetCamParam neu setzen. RV1126/RV1109 und RK3576 unterstützen keinen dynamischen Wechsel von Auflösung und Kodierungstyp: zuerst RKADK_RTSP_DeInit aufrufen, die neue Auflösung bzw. den Kodierungstyp einstellen und danach erneut RKADK_RTSP_Init aufrufen. Teilen Live und andere Module den VI-Kanal, müssen ihre Auflösungen gleichzeitig umgestellt werden, damit VI- und VENC-Auflösung übereinstimmen.

8.2.2 RTMP

8.2.2.1 RKADK_RTMP_Init

Beschreibung

RTMP-Modul initialisieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtmp.h. Bibliothek: librkadk.so

Beispiel

rkadk_rtmp_test

Siehe auch

RKADK_RTMP_DeInit

8.2.2.2 RKADK_RTMP_DeInit

Beschreibung

RTMP-Modul deinitialisieren.

Syntax

RKADK_S32 RKADK_RTMP_DeInit(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtmp.h. Bibliothek: librkadk.so

Beispiel

rkadk_rtmp_test

Siehe auch

RKADK_RTMP_Init

8.2.2.3 RKADK_RTSP_VideoReset

Beschreibung

RTSP-Live-Streaming neu konfigurieren.

Syntax

RKADK_S32 RKADK_RTSP_VideoReset(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_rtsp.h. Bibliothek: librkadk.so

Hinweis

RKADK_RTMP_VideoReset ist erst nach RKADK_RTMP_Init verwendbar. Beim Ändern von Auflösung, Bildrate, Bitrate, Kodierungs- oder Aufzeichnungstyp die Live-Parameter in der ini-Datei über RKADK_PARAM_SetCamParam neu setzen. RV1126/RV1109 und RK3576 unterstützen keinen dynamischen Wechsel von Auflösung und Kodierungstyp: zuerst RKADK_RTMP_DeInit aufrufen, die neue Auflösung bzw. den Kodierungstyp einstellen und danach erneut RKADK_RTMP_Init aufrufen. Teilen Live und andere Module den VI-Kanal, müssen ihre Auflösungen gleichzeitig umgestellt werden, damit VI- und VENC-Auflösung übereinstimmen.

9. Speicherung

9.1 Überblick

Stellt grundlegende Speicherfunktionen bereit: Dateien erkennen, speichern, abrufen und verwalten; Gerätekapazität und -status abfragen; Dateien automatisch löschen; formatieren.

9.2 API-Referenz

9.2.1 RKADK_STORAGE_Init

Beschreibung

Speichermodul initialisieren.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_storage.h. Bibliothek: librkadk.so

Hinweis

Eine wiederholte Initialisierung wird nicht unterstützt. Wird RKADK_STR_DEV_ATTR als NULL übergeben, gelten die Standardattribute: zwei Ordner video_front und video_back, Sortierung nach Dateiname, automatische Löschschwelle 500~1000M, keine Begrenzung der Dateianzahl und ein Anteil von 50%.

Beispiel

rkadk_storage_test

Siehe auch

RKADK_STORAGE_Deinit

9.2.2 RKADK_STORAGE_Deinit

Beschreibung

Speichermodul deinitialisieren.

Syntax

RKADK_S32 RKADK_STORAGE_Deinit(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_storage.h. Bibliothek: librkadk.so

Hinweis

Wiederholte Deinitialisierung wird nicht unterstützt.

Beispiel

rkadk_storage_test

Siehe auch

RKADK_STORAGE_Init

9.2.3 RKADK_STORAGE_GetDevAttr

Beschreibung

Attribute des eingehängten Geräts abrufen.

Syntax

RKADK_STR_DEV_ATTR RKADK_STORAGE_GetDevAttr(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_storage.h. Bibliothek: librkadk.so

Hinweis

RKADK_STORAGE_GetDevAttr ist erst nach der Initialisierung des Speichermoduls verwendbar.

Beispiel

Keine

Siehe auch

Keine

9.2.4 RKADK_STORAGE_GetMountStatus

Beschreibung

Einbindestatus des Geräts abrufen.

Syntax

RKADK_MOUNT_STATUS RKADK_STORAGE_GetMountStatus(RKADK_MW_PTR pHandle);

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_storage.h

Bibliothek: librkadk.so

Beispiel

rkadk_storage_test

Siehe auch

Keine

9.2.5 RKADK_STORAGE_GetCapacity

Beschreibung

Gerätekapazität abrufen.

Syntax

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

Parameter

Rückgabewert

Voraussetzungen

Header-Datei: rkadk_storage.h. Bibliothek: librkadk.so

Beispiel

rkadk_storage_test

Siehe auch

Keine

9.2.6 RKADK_STORAGE_GetFileList

Beschreibung

Dateiliste abrufen.

Syntax

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

Parameter

Rückgabewert