モバイル開発におけるカメラ：概要、APIの種類、使用方法

モバイルアプリケーションにおけるカメラとは

モバイルカメラは、レンズ、イメージセンサー、画像信号プロセッサ（ISP）で構成される統合光学モジュールです。開発者は専用のフレームワークを使用してオペレーティングシステムを通じてカメラにアクセスします。AndroidではCamera2 API（低レベル）とCameraX（高レベル、Camera2ベース）、iOSではAVFoundationと単純なシナリオ向けのUIKitがあります。各プラットフォームは独自のツールセットを提供しますが、基本概念は同じです：アプリケーションがキャプチャセッションを初期化し、パラメータ（解像度、フォーカス、露出）を設定し、フレームストリームまたは個別の画像を受信します。

最新カメラのハードウェア機能

最新のモバイルカメラは多くの撮影モードをサポートしています：HDR、ナイトモード、背景ぼかしのポートレート、スローモーション動画、RAW形式での録画。開発者はソフトウェア設定（ISO（センサー感度）、シャッタースピード（露出）、ホワイトバランス、フォーカス（自動および手動）、手ぶれ補正）にアクセスできます。フラッグシップデバイスでは異なる焦点距離の最大4台のカメラを搭載でき、アプリケーションはIDで特定のカメラを選択できます。

カメラ操作のためのAPIの種類

モバイルプラットフォームはカメラ操作のための複数のAPIを提供しており、抽象化レベルと機能が異なります。特定のAPIの選択はプロジェクトの要件に依存します：単純な写真キャプチャにはCameraXまたはUIImagePickerControllerで十分です；プロフェッショナルなアプリケーションにはセンサーを直接制御するCamera2またはAVFoundationが必要です。以下に主要なAPIの比較を示します。

CameraXを選ぶべき場合

CameraXは、高度なカスタマイズを必要とせずにカメラ機能を必要とするほとんどのAndroidアプリケーションにとって最適な選択肢です。ライブラリはActivityとFragmentのライフサイクルを自動的に処理し、権限をサポートし、異なるAndroidバージョン間での互換性を保証します。CameraXは互換性レイヤーにより、95%のAndroidデバイスで一貫した動作を保証します。カメラプレビュー（Preview）、写真キャプチャ（ImageCapture）、フレーム解析（ImageAnalysis）のいずれが必要な場合でも、CameraXは複雑なコードを書くことなく3つのシナリオすべてを処理します。

Camera2を選ぶべき場合

Camera2はプロフェッショナルなシナリオ向けの低レベルAPIです：RAW録画、手動露出調整、バーストキャプチャ、複数カメラの同時制御。Camera2を使用するには、開発者は画像キャプチャパイプライン、ステートマシン管理、コールバック処理の深い理解が必要です。Camera2はCameraXが要件をカバーしない場合にのみ使用してください：例えば、手動フォーカスによる文書スキャンアプリケーションや非標準解像度のカスタムカメラなどです。

カメラ権限のリクエスト

カメラへのアクセスには両プラットフォームでユーザーの明示的な許可が必要です。AndroidではCAMERA権限をマニフェストに追加し、Android 6.0以降では実行時にActivityCompat.requestPermissionsを通じて権限をリクエストする必要もあります。iOSではInfo.plistにNSCameraUsageDescriptionキーを追加し、カメラを使用する理由を説明します。この説明がないと、カメラにアクセスしようとしたときにアプリケーションがクラッシュします。iOS 14以降、権限ダイアログにはアプリケーション名だけでなく指定された理由も表示されます—文言はユーザーにとって明確でなければなりません。

CameraXを使用したAndroidでの実装

CameraXはカメラ操作をわずか数行のコードに簡素化します。プレビューを開始するには、Previewインスタンスを作成し、LifecycleOwnerにバインドし、表示用のSurfaceProviderを取得する必要があります。写真キャプチャには保存先を指定したImageCaptureを使用します。以下はKotlinでCameraXを使用してカメラを起動し写真を撮影する完全な例です。

PreviewとImageCaptureの設定

val preview = Preview.Builder()
    .build()
    .also {
        it.surfaceProvider = viewFinder.surfaceProvider
    }

val imageCapture = ImageCapture.Builder()
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
    .build()

val cameraProviderFuture = ProcessCameraProvider.getInstance(this)
cameraProviderFuture.addListener(Runnable {
    val cameraProvider = cameraProviderFuture.get()
    val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA

    try {
        cameraProvider.unbindAll()
        cameraProvider.bindToLifecycle(
            this, cameraSelector, preview, imageCapture
        )
    } catch (e: Exception) {
        Log.e("CameraX", "バインド失敗", e)
    }
}, ContextCompact.getMainExecutor(this))

bindToLifecycleメソッドはカメラをActivityのライフサイクルにバインドします—画面が回転したりアプリケーションがバックグラウンドに移動したりすると、カメラは自動的に解放されます。CameraSelector.DEFAULT_BACK_CAMERAはリアカメラを選択し、フロントカメラにはDEFAULT_FRONT_CAMERAを使用します。バインド後、PreviewはPreviewViewにカメラフィードを表示し始め、ユーザーは画面にカメラ画像を表示します。

写真のキャプチャ

val photoFile = File(
    externalMediaDirs.firstOrNull(),
    "IMG_${System.currentTimeMillis()}.jpg"
)
val outputOptions = ImageCapture.OutputFileOptions
    .Builder(photoFile)
    .build()

imageCapture.takePicture(
    outputOptions,
    ContextCompact.getMainExecutor(this),
    object : ImageCapture.OnImageSavedCallback {
        override fun onImageSaved(output: ImageCapture.OutputFileResults) {
            Log.d("CameraX", "Photo saved: ${photoFile.absolutePath}")
        }
        override fun onError(exception: ImageCaptureException) {
            Log.e("CameraX", "キャプチャエラー", exception)
        }
    }
)

takePictureメソッドはカメラからフレームをキャプチャしてファイルに保存します。OutputFileOptionsはFile、ContentResolver、MediaStoreへの書き込みをサポートします。onImageSavedコールバックで、アプリケーションは保存成功の通知を受け取り、UIを更新できます。CAPTURE_MODE_MINIMIZE_LATENCYは後処理を削減して最大のシャッター速度を確保します。

AVFoundationを使用したiOSでの実装

iOSでは、カメラへのアクセスはAVFoundationフレームワークのAVCaptureSessionクラスを通じて提供されます。開発者はキャプチャセッションを作成し、必要な入力（AVCaptureDeviceInput）と出力（AVCapturePhotoOutput、AVCaptureVideoDataOutput）を追加してセッションを開始します。プレビュー表示にはAVCaptureVideoPreviewLayerを使用します。以下はSwiftで写真キャプチャ用のセッションを設定する例です。

import AVFoundation

let captureSession = AVCaptureSession()
captureSession.sessionPreset = .photo

guard let camera = AVCaptureDevice.default(
    for: .video
) else { return }

guard let input = try? AVCaptureDeviceInput(device: camera)
else { return }

let output = AVCapturePhotoOutput()
captureSession.addInput(input)
captureSession.addOutput(output)

DispatchQueue.global(qos: .userInitiated).async {
    captureSession.startRunning()
}

AVCaptureSessionPreset.photoは写真に最適な解像度を設定します（最新デバイスでは通常12MP）。入力はデバイスのカメラ用に作成されたAVCaptureDeviceInputです。入力と出力を追加した後、セッションはstartRunningを通じてバックグラウンドスレッドで開始されます—古いデバイスではセッションの開始に最大200msかかる場合があります。写真をキャプチャするにはcapturePhoto(with:delegate:)を呼び出し、結果はAVCapturePhotoCaptureDelegateを通じて返されます。

特徴と制限事項

モバイルデバイスでカメラを扱う際には、ハードウェアの制限を考慮する必要があります：長時間の録画によるデバイスの発熱、高解像度での作業によるバッテリー消費、デバイスごとのカメラ品質の違い。Androidではエコシステムの断片化により、同じCameraX設定でもモデルによって動作が異なる場合があります。iOSでは制限は主にライセンスに関するものです：バックグラウンドでのカメラ使用にはAppleの特別な許可が必要です。シミュレーターは実際のカメラにアクセスできないことも重要です—テストは物理デバイスでのみ可能です。

異なるOSバージョンとの互換性

CameraXはCameraXConfig互換性レイヤーを通じてAndroidの断片化問題を解決します—ライブラリは既知のメーカーバグに対する回避策を自動的に適用します。iOSではAVFoundationはiOS 6以降のすべてのデバイスで一貫して動作しますが、一部の機能（ポートレートモードやLiDARなど）はiPhone 12以降のモデルでのみ利用可能です。クロスプラットフォームアプリケーションを開発する場合は、カメラプラグインを備えたFlutterまたはReact Nativeの使用をお勧めします—これらはプラットフォームの違いを抽象化し、両方のオペレーティングシステムに統一されたAPIを提供します。