
La couche d'abstraction matérielle de la caméra (HAL) d'Android connecte les API de cadre de caméra de niveau supérieur dans Camera 2 à votre pilote et à votre matériel de caméra sous-jacents. Le sous-système de caméra comprend des implémentations pour les composants de pipeline de caméra, tandis que la HAL de caméra fournit des interfaces à utiliser pour implémenter votre version de ces composants.
Architecture
La figure et la liste suivantes décrivent les composants HAL.

Figure 1. Architecture de la caméra
- cadre d'application
- Au niveau du cadre de l'application se trouve le code de l'application, qui utilise l'API Camera 2 pour interagir avec le matériel de la caméra. En interne, ce code appelle les interfaces Binder correspondantes pour accéder au code natif qui interagit avec la caméra.
- AIDL
- L'interface de classeur associée à
CameraService
se trouve dans frameworks / av / camera / aidl / android / hardware . Le code généré appelle le code natif de niveau inférieur pour obtenir l' accès à la caméra physique et renvoie les données utilisées pour créer leCameraDevice
et éventuellementCameraCaptureSession
objets au niveau du cadre. - framework natif
- Ce résidant cadre dans des
frameworks/av/
fournit un équivalent natif auxCameraDevice
etCameraCaptureSession
classes. Voir aussi la référence NDK camera2 . - interface IPC du classeur
- L'interface de liant IPC facilite la communication au-delà des limites du processus. Il existe plusieurs classes de classeur de caméras situées dans le répertoire
frameworks/av/camera/camera/aidl/android/hardware
qui appellent le service de caméra.ICameraService
est l'interface avec le service de caméra;ICameraDeviceUser
est l'interface vers un appareil photo ouvert spécifique; etICameraServiceListener
etICameraDeviceCallbacks
sont lesCameraService
respectifsCameraService
etCameraDevice
vers le cadre d'application. - service de caméra
- Le service de caméra, situé dans
frameworks/av/services/camera/libcameraservice/CameraService.cpp
, est le code réel qui interagit avec le HAL. - HAL
- La couche d'abstraction matérielle définit l'interface standard à laquelle le service de caméra appelle et que vous devez implémenter pour que le matériel de votre caméra fonctionne correctement.
Mettre en œuvre le HAL
Le HAL se situe entre le pilote de la caméra et le cadre Android de niveau supérieur et définit une interface que vous devez implémenter pour que les applications puissent faire fonctionner correctement le matériel de la caméra. Les interfaces HIDL pour la caméra HAL sont définies dans matériel / interfaces / caméra .
Un HAL classique lié doit implémenter les interfaces HIDL suivantes:
-
ICameraProvider
: pour énumérer les appareils individuels et gérer leur état. -
ICameraDevice
: l'interface de l'appareil photo. -
ICameraDeviceSession
: interface de session de l'appareil photo actif.
Des implémentations HIDL de référence sont disponibles pour CameraProvider.cpp
, CameraDevice.cpp
et CameraDeviceSession.cpp
. L'implémentation encapsule les anciennes HAL qui utilisent toujours l' ancienne API . À partir d'Android 8.0, les implémentations Camera HAL doivent utiliser l'API HIDL; l'utilisation de l'ancienne interface n'est pas prise en charge.
Composants HAL hérités
Cette section décrit l'architecture des composants HAL hérités et comment implémenter la HAL. Les implémentations de Camera HAL sur Android 8.0 et supérieur doivent utiliser l'API HIDL à la place, décrite ci-dessus.
Architecture (héritage)
La figure et la liste suivantes décrivent les composants HAL de la caméra héritée.

Figure 2. Architecture de caméra héritée
- cadre d'application
- Au niveau du cadre de l'application se trouve le code de l'application, qui utilise l'API
android.hardware.Camera
pour interagir avec le matériel de la caméra. En interne, ce code appelle une classe de colle JNI correspondante pour accéder au code natif qui interagit avec la caméra. - JNI
- Le code JNI associé à
android.hardware.Camera
se trouve dansframeworks/base/core/jni/android_hardware_Camera.cpp
. Ce code appelle le code natif de niveau inférieur pour obtenir l'accès à la caméra physique et renvoie les données utilisées pour créer l'objetandroid.hardware.Camera
au niveau du framework. - framework natif
- Le framework natif défini dans
frameworks/av/camera/Camera.cpp
fournit un équivalent natif de la classeandroid.hardware.Camera
. Cette classe appelle les proxys du classeur IPC pour accéder au service de caméra. - proxys IPC de classeur
- Les proxys de liant IPC facilitent la communication au-delà des limites du processus. Il existe trois classes de classeur de caméra situées dans le répertoire
frameworks/av/camera
qui appelle le service de caméra.ICameraService
est l'interface avec le service de caméra,ICamera
est l'interface vers un appareil de caméra ouvert spécifique etICameraClient
est l'interface de l'appareil avec le framework de l'application. - service de caméra
- Le service de caméra, situé dans
frameworks/av/services/camera/libcameraservice/CameraService.cpp
, est le code réel qui interagit avec le HAL. - HAL
- La couche d'abstraction matérielle définit l'interface standard à laquelle le service de caméra appelle et que vous devez implémenter pour que le matériel de votre caméra fonctionne correctement.
- pilote du noyau
- Le pilote de la caméra interagit avec le matériel réel de la caméra et votre implémentation de la HAL. La caméra et le pilote doivent prendre en charge les formats d'image YV12 et NV21 pour prendre en charge la prévisualisation de l'image de la caméra sur l'écran et l'enregistrement vidéo.
Implémentation du HAL (héritage)
Le HAL se situe entre le pilote de la caméra et le cadre Android de niveau supérieur et définit une interface que vous devez implémenter pour que les applications puissent faire fonctionner correctement le matériel de la caméra. L'interface HAL est définie dans les fichiers d'en-tête hardware/libhardware/include/hardware/camera.h
et hardware/libhardware/include/hardware/camera_common.h
.
camera_common.h
définit camera_module
, une structure standard pour obtenir des informations générales sur la caméra, telles que l'ID de caméra et les propriétés communes à toutes les caméras (c'est-à-dire s'il s'agit d'une caméra frontale ou arrière).
camera.h
contient du code qui correspond à android.hardware.Camera
. Ce fichier d'en-tête déclare une structure camera_device
qui à son tour contient une structure camera_device_ops
avec des pointeurs vers des fonctions qui implémentent l'interface HAL. Pour obtenir de la documentation sur les paramètres de caméra que les développeurs peuvent définir, reportez-vous à frameworks/av/include/camera/CameraParameters.h
. Ces paramètres sont définis avec la fonction pointée par int (*set_parameters)(struct camera_device *, const char *parms)
dans la HAL.
Pour un exemple d'implémentation HAL, reportez-vous à l'implémentation du Galaxy Nexus HAL dans hardware/ti/omap4xxx/camera
.
Configurer la bibliothèque partagée
Configurez le système de construction Android pour emballer correctement l'implémentation HAL dans une bibliothèque partagée et copiez-la à l'emplacement approprié en créant un fichier Android.mk
:
- Créez un
device/<company_name>/<device_name>/camera
pour contenir les fichiers source de votre bibliothèque. - Créez un fichier
Android.mk
pour créer la bibliothèque partagée. Assurez-vous que le makefile contient les lignes suivantes:LOCAL_MODULE := camera.<device_name> LOCAL_MODULE_RELATIVE_PATH := hw
Votre bibliothèque doit être nommée
camera.<device_name>
(.so
est ajouté automatiquement) pour qu'Android puisse charger correctement la bibliothèque. Pour un exemple, consultez le fichier makefile de la caméra Galaxy Nexus situé danshardware/ti/omap4xxx/Android.mk
. - Spécifiez que votre appareil possède des fonctionnalités de caméra en copiant les fichiers XML de fonctionnalités nécessaires dans le répertoire
frameworks/native/data/etc
avec le fichier makefile de votre appareil. Par exemple, pour spécifier que votre appareil dispose d'un flash d'appareil photo et peut effectuer une mise au point automatique, ajoutez les lignes suivantes dans<device>/<company_name>/<device_name>/device.mk
makefile:PRODUCT_COPY_FILES := \ ... PRODUCT_COPY_FILES += \ frameworks/native/data/etc/android.hardware.camera.flash-autofocus.xml:system/etc/permissions/android.hardware.camera.flash-autofocus.xml \
Pour un exemple de
device/samsung/tuna/device.mk
makefile de périphérique, voirdevice/samsung/tuna/device.mk
. - Déclarez les capacités de codec multimédia, de format et de résolution de votre caméra dans les fichiers XML
device/<company_name>/<device_name>/media_profiles.xml
etdevice/<company_name>/<device_name>/media_codecs.xml
. Pour plus de détails, consultez Présentation des codecs au framework . - Ajoutez les lignes suivantes dans le
device/<company_name>/<device_name>/device.mk
votre appareil pour copier les fichiersmedia_profiles.xml
etmedia_codecs.xml
à l'emplacement approprié:# media config xml file PRODUCT_COPY_FILES += \ <device>/<company>/<device>/media_profiles.xml:system/etc/media_profiles.xml # media codec config xml file PRODUCT_COPY_FILES += \ <device>/<company>/<device>/media_codecs.xml:system/etc/media_codecs.xml
- Pour inclure l'application Appareil photo dans l'image système de votre appareil, spécifiez-la dans la variable
PRODUCT_PACKAGES
de l'device/<company>/<device>/device.mk
makefile:PRODUCT_PACKAGES := \ Gallery2 \ ...