2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main ではなく android-latest-release を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。

このページは Cloud Translation API によって翻訳されました。

Camera2 に移行する

このページでは、拡張ビューシステム（EVS）と Camera2 の違いについて説明します。また、Camera2 の実装を設定する方法についても説明します。

カメラを開閉する

EVS

openCamera は、デバイスを開くことと単一のストリームを構成することを組み合わせます。

Camera2

Camera2 でデバイスを開閉するには:

次のいずれかのモードを選択します。
- 排他モードでは、ネイティブ開発キット（NDK）で CameraManager.openCamera（Java）または ACameraManager_openCamera を使用します。
- 共有モードの場合は、openSharedCamera または ACameraManager_openSharedCamera を使用します。カメラの共有を有効にする場合は、共有セッション構成を指定します。
ストリームを構成するには、関連する出力サーフェスを使用してキャプチャセッションを作成します。たとえば、CameraDevice.createCaptureSession()（Java）または ACameraDevice_createCaptureSession()（NDK）の ImageReader または SurfaceView から。

Camera2 は、複数のストリームの同時使用をサポートしています。プレビュー、録画、画像処理などの目的で複数のストリームを作成します。ストリームは並列パイプラインとして機能し、カメラからの未加工フレームを順次処理します。
カメラデバイスを閉じるには、CameraDevice.close()（Java）または ACameraDevice_close()（NDK）を使用します。

次のコードスニペットを検討してください。

Java

CameraManager manager = (CameraManager) getSystemService(Context.CAMERA_SERVICE);
try {
    manager.openCamera(cameraId, new CameraDevice.StateCallback() {
        @Override
        public void onOpened(@NonNull CameraDevice camera) {
            // Camera opened, now create session
        }
        @Override
        public void onDisconnected(@NonNull CameraDevice camera) {}
        @Override
        public void onError(@NonNull CameraDevice camera, int error) {}
    }, handler);
} catch (CameraAccessException e) {
    // Handle exception
}

NDK

ACameraManager *cameraManager = ACameraManager_create();
ACameraDevice *cameraDevice = nullptr;
camera_status_t status = ACameraManager_openCamera(
    cameraManager, cameraId, &deviceStateCallbacks, &cameraDevice);

カメラデータをストリーミングする

このセクションでは、カメラデータをストリーミングする方法について説明します。

EVS

EVS で、次の操作を行います。

ストリーミングを開始します。startVideoStream を使用します。
ストリーミングを停止するには、stopVideoStream を使用します。

Camera2

Camera2 では、

プレビューに適した CaptureRequest を作成します。Java では CameraDevice.createCaptureRequest() を使用して TEMPLATE_PREVIEW を、NDK では ACameraDevice_createCaptureRequest() を使用します。
継続的なストリーミングのリクエストを送信するには、CameraCaptureSession.setSingleRepeatingRequest（Java）または ACameraCaptureSession_setRepeatingRequestV2（NDK）を使用します。
ストリーミングを停止するには、CameraCaptureSession.stopRepeating（Java）または ACameraCaptureSession_stopRepeating（NDK）を使用します。

バッファ管理

EVS では、以前は setMaxFramesInFlight がバッファ数を制御しており、ストリームの途中で変更される可能性がありました。カメラストリーミングが開始されると、EVS は各画像フレームのバッファ ID を提供しました。これは、メモリ内の同じハードウェアバッファアドレスに関連付けられています。
Camera2 では、セッションの初期化時に AImageReader_new または ImageReader.newInstance を使用して、AImageReader または ImageReader の画像の最大数を設定します。セッションが開始されると、この設定を動的に変更することはできません。各フレームのバッファ ID を取得するために、クライアントは Image オブジェクトから取得したハードウェアバッファアドレスを一意の識別子に関連付けるマップを維持できます。

ストリーミングを一時停止、再開する

EVS は pauseVideoStream と resumeVideoStream を使用していました。
Camera2 に直接相当するものはありません。代わりに、次のようにします。
- 一時停止、stopRepeating を使用
- 再開、setSingleRepeatingRequest を使用

カメラパラメータ

EVS は、setIntParameter などのメソッドを使用して、カメラキャプチャリクエストパラメータを変更しました。
Camera2 でパラメータを変更するには、CaptureRequest ビルダーの set API を呼び出して送信します。

次のコードサンプルを考えてみましょう。

Java

CaptureRequest.Builder builder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
builder.set(CaptureRequest.CONTROL_EFFECT_MODE, CaptureRequest.CONTROL_EFFECT_MODE_MONO);
// Submit this request

NDK

ACaptureRequest_setEntry_i32(captureRequest, ACAMERA_CONTROL_EFFECT_MODE, 1, &effectMode);

論理カメラ

EVS: サラウンドビューなどの論理カメラの場合、EVS Manager は関連するすべての物理カメラを開き、動画ストリームを開始して、一貫性のある画像配列を提供しました。
Camera2: Camera2 で同様の機能が必要な場合、アプリは論理カメラを管理する必要があります。そのためには、次の操作が必要です。
- 論理カメラに関連付けられている物理サブカメラを特定します。
- 必要な物理カメラをそれぞれ開きます。
- 各カメラでストリームを開始します。
- 必要に応じてフレームを同期します。最適には、これはハードウェアレベルの同期のために HAL で処理されます。

移行を容易にするため、既存の EVS クライアントに互換性ライブラリ（シムレイヤ）を提供します。コードの変更を最小限に抑えながら Camera2 API をサポートすることを目的としています。

権限

EVS

アクセスは、特権の一意の識別子（UID）に制限されます。例: AID_AUTOMOTIVE_EVS。非推奨の権限には android.car.permission.USE_CAR_EVS_CAMERA が含まれます。

Camera2

Camera2 には android.permission.CAMERA が必要です。特別なケースの場合:

android.permission.SYSTEM_CAMERA: サードパーティ製アプリから隠されているカメラにアクセスするため。CAMERA 権限も必要です。詳しくは、システムカメラをご覧ください。
android.permission.CAMERA_HEADLESS_SYSTEM_USER: User 0 からのアクセスを許可します。これは、ユーザー切り替えをまたいで実行する必要があるバックミラーカメラなどのサービスにとって重要です。事前に付与された CAMERA 権限が必要です。
android.permission.CAMERA_PRIVACY_ALLOWLIST: OEM が、特定の安全重視アプリをユーザー制御のカメラプライバシートグルから除外できるようにします。

安全上重要なカメラアプリは、Design for Driving で提供されている Google の組み込み事前付与ポリシーに準拠する必要があります。

プライマリクライアントとセカンダリクライアント

カメラへのアクセスを共有する場合:

EVS は、パラメータを変更する権限を持つプライマリクライアントを管理するために、明示的な API（setPrimaryClient と forcePrimaryClient）を提供していました。
Camera2 では、カメラが共有モードで開かれた場合（Android 16 以降）、カメラにアクセスするクライアントの優先度によってプライマリクライアントが決定されます。優先度が最も高いクライアント（通常はフォアグラウンドアプリ）は、キャプチャリクエストパラメータを変更できます。プライマリステータスを強制するために直接 API が使用されることはありません。プライマリステータスはフレームワークによって管理されます。

システムカメラ

カメラデバイスへのアクセスをシステムアプリまたはファーストパーティ製アプリのみに制限するには、そのデバイスのカメラ HAL で ANDROID_REQUEST_AVAILABLE_CAPABILITIES_SYSTEM_CAMERA 機能を宣言します。クライアントは、このカメラデバイスに接続する android.permission.CAMERA に加えて android.permission.SYSTEM_CAMERA を持っている必要があります。

CarEVSManager と CarEVSService

API アクセスの場合、Java アプリは CarEVSManager ではなく標準の android.hardware.camera2.CameraManager を使用する必要があります。

リアビューカメラの場合、GEAR_SELECTION VHAL プロパティをモニタリングし、アクティビティを起動する CarEVSService のロジックは、OEM 所有のアプリに移行しなければなりません。このアプリは、

GEAR_SELECTION VHAL プロパティをモニタリングします。
バックギアがオンになったときに、バックカメラアクティビティを起動します。
Camera2 API を使用してカメラフィードを表示します。

リアビューカメラを常に遮られることなく表示するため、特にユーザーの切り替え時や、他のアプリがプレビューを隠す可能性がある場合は、Camera2 でリアビューカメラ機能を実装する際に次のガイドラインに沿うことをおすすめします。

リアビューカメラをシステムカメラとしてマークします。
CAMERA_HEADLESS_SYSTEM_USER 権限を使用して、カメラにアクセスするサービスまたはアプリを User 0 として実行します。
アプリをカメラのプライバシー許可リストに追加します。

ディスプレイのレンダリング

EVS ディスプレイと自動車ディスプレイサービス。

これらは非推奨です。

Camera2

Surface、android.hardware.display.DisplayManager、android.view.Display で標準の Android レンダリングメソッドを使用します。

カメラの早期表示が必要なシナリオでは、Camera2 ImageReader がハードウェアバッファへの直接アクセスを提供するため、既存の DRM ベースのディスプレイ実装と統合してレンダリングできます。

カメラへの早期アクセスは、AID_AUTOMOTIVE_EVS_UID を持つ特権クライアントにのみ許可され、車両の外部に配置されたシステムカメラに限定されます。

エミュレータ HAL（EVS モック HAL）

EVS Mock HAL は非推奨となる予定です。代わりに、OEM は Camera2 エミュレートカメラ HAL（hardware/google/camera/devices/EmulatedCamera/）を使用する必要があります。これは、次の機能をサポートするように強化されます。

構成可能なカメラの数。
カラーバーのテストパターン。
動画ファイルのエミュレーション。

この HAL をビルドに含めるには:

# In device.mk
PRODUCT_SOONG_NAMESPACES += hardware/google/camera/devices/EmulatedCamera
PRODUCT_PACKAGES += com.google.emulated.camera.provider.hal

また、cameraserver がエミュレートされたカメラ HAL サービスとやり取りできるように、適切なセキュリティ強化された Linux（SELinux）ポリシーも必要です。

V4L2 UVC カメラ HAL

EVS V4L2 HAL は非推奨となる予定です。USB カメラ（UVC）に Camera2 外部カメラのサポートを使用します。詳しくは、外部 USB カメラをご覧ください。

カメラへの早期アクセス

EVS カメラへのアクセスは、AID_AUTOMOTIVE_EVS UID を持つ特権クライアントに限定されていました。UID が AID_AUTOMOTIVE_EVS のままであれば、Android の起動プロセスが完了する前にカメラにアクセスできます。ただし、カメラへの早期アクセスは、車両の外部に配置されたシステムカメラに限定されています。

超音波 API

EVS 超音波 API は非推奨となる予定です。代わりに、Android 15 で導入されたこれらの VHAL プロパティを、超音波センサーの検出に使用します。

プロパティ	タイプ	定義
`ULTRASONICS_SENSOR_POSITION`	静的	`{<x>, <y>, <z>}` ミリメートル単位で、各値は AAOS センサー座標フレームを基準とした、関連付けられた軸に沿ったセンサーの位置を表します。
`ULTRASONICS_SENSOR_ORIENTATION`	静的	`{<qw>, <qx>, <qy>, <qz>}` これは、AAOS センサー座標フレームに対するセンサーの四元数回転です。 $$w+xi+yj+zk$$
`ULTRASONICS_SENSOR_FIELD_OF_VIEW`	静的	`{<horizontal>, <vertical>}` センサーの水平方向と垂直方向の視野角（度単位）。
`ULTRASONICS_SENSOR_DETECTION_RANGE`	静的	`{<minimum>, <maximum>}` センサーの検出範囲（ミリメートル単位）。
`ULTRASONICS_SENSOR_DETECTION_RANGES`	静的	`{<range_min_1>, <range_max_1>, <range_min_2>, <range_max_2>}` センサーがサポートする検出範囲の配列（ミリメートル単位、両端を含む）。
`ULTRASONICS_SENSOR_DETECTION_RANGES`	継続	`{<distance>, <distance_error>}` センサーの測定距離と距離誤差（ミリメートル単位）。範囲のみがサポートされている場合、これは検出された範囲の最小距離です。

概要

Camera2 API のマッピング

Camera2 に移行する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

カメラを開閉する

EVS

Camera2

Java

NDK

カメラデータをストリーミングする

EVS

Camera2

バッファ管理

ストリーミングを一時停止、再開する

カメラ パラメータ

Java

NDK

論理カメラ

権限

EVS

Camera2

プライマリ クライアントとセカンダリ クライアント

システムカメラ

CarEVSManager と CarEVSService

ディスプレイのレンダリング

EVS ディスプレイと自動車ディスプレイ サービス。

Camera2

エミュレータ HAL（EVS モック HAL）

V4L2 UVC カメラ HAL

カメラへの早期アクセス

超音波 API

Camera2 に移行する

カメラパラメータ

プライマリクライアントとセカンダリクライアント

EVS ディスプレイと自動車ディスプレイサービス。