カメラを利用する

このページでは CameraX というカメラを使用するアプリを簡単に開発するためのライブラリを使用したサンプルを紹介します。

依存関係の追加

モジュールの build.gradle ファイルにCameraXの依存関係を追加します。

android {

...

    compileOptions {

        // Java8互換を指定

        sourceCompatibility JavaVersion.VERSION_1_8

        targetCompatibility JavaVersion.VERSION_1_8

dependencies {

...

    def camerax_version = "1.0.0-beta03"

    implementation "androidx.camera:camera-camera2:${camerax_version}"

    implementation "androidx.camera:camera-lifecycle:${camerax_version}"

    implementation "androidx.camera:camera-view:1.0.0-alpha10"

今回は activity_main.xml ファイルを編集してレイアウトを定義します。以下のコードで右図のような写真を撮るボタンと、まだ表示されていませんがカメラのプレビューを配置します。

   <Button

       android:id="@+id/camera_capture_button"

       android:layout_width="100dp"

       android:layout_height="100dp"

       android:layout_marginBottom="50dp"

       android:scaleType="fitCenter"

       android:text="Take Photo"

       app:layout_constraintLeft_toLeftOf="parent"

       app:layout_constraintRight_toRightOf="parent"

       app:layout_constraintBottom_toBottomOf="parent"

       android:elevation="2dp" />

   <androidx.camera.view.PreviewView

       android:id="@+id/viewFinder"

       android:layout_width="match_parent"

       android:layout_height="match_parent" />

カメラを利用するにはユーザに権限をリクエストする必要があります。

まず、MainActivity.kt ファイルから編集していきます。

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {

        super.onCreate(savedInstanceState)

        setContentView(R.layout.activity_main)

        // カメラ権限を確認 -> startCamera or 権限リクエスト

        if (allPermissionGranted()) {

            startCamera()

        } else {

            ActivityCompat.requestPermissions(this, REQUIRED_PERMISSIONS, REQUEST_CODE_PERMISSIONS)

    // 権限リクエスト後の処理

    override fun onRequestPermissionsResult(

        requestCode: Int,

        permissions: Array<String>,

        grantResults: IntArray

) {

        if (requestCode == REQUEST_CODE_PERMISSIONS) {

            // カメラ権限を確認 -> startCamera or エラーメッセージを表示

            if (allPermissionGranted()) {

                startCamera()

            } else {

                Toast.makeText(this, "Permissions not granted by the user.", Toast.LENGTH_SHORT)

                    .show()

                finish()

    // スタブ

    private fun startCamera() {}

    // 必要な権限の確認

    private fun allPermissionGranted() = REQUIRED_PERMISSIONS.all {

        ContextCompat.checkSelfPermission(baseContext, it) == PackageManager.PERMISSION_GRANTED

    companion object {

        // カメラ権限のリクエストコード

        private const val REQUEST_CODE_PERMISSIONS = 10

        // 必要な権限を定義

        private val REQUIRED_PERMISSIONS = arrayOf(Manifest.permission.CAMERA)

次に、 AndroidManifest.xml ファイルに以下を追加します。

<!-- カメラを機能要件として宣言 -->

<uses-feature android:name="android.hardware.camera.any" />

<!-- カメラ権限の要求を宣言 -->

<uses-permission android:name="android.permission.CAMERA" />

まだ実際にカメラのプレビューを表示する関数は実装していませんが、この状態でアプリを起動すると、右図のように初回起動時にカメラ権限を要求するダイアログが表示されるはずです。

MainActivity.kt ファイルの startCamera関数を実装していきます。

class MainActivity : AppCompatActivity() {

    // 後でプレビューを保持させる

    private var preview: Preview? = null

    // 後でカメラを保持させる

    private var camera: Camera? = null

...

    // カメラプレビューの開始

    private fun startCamera() {

        // カメラの `lifecycle` を生成 (生存期間や競合を管理してくれる）

        val cameraProviderFuture = ProcessCameraProvider.getInstance(this)

        cameraProviderFuture.addListener(Runnable {

            // カメラの `lifecycle` を取得（=このプロセスにバインド）

            val cameraProvider = cameraProviderFuture.get()

            // プレビュー画面を生成

            preview = Preview.Builder().build()

            // バックカメラを選択

            val cameraSelector =

                CameraSelector.Builder().requireLensFacing(CameraSelector.LENS_FACING_BACK).build()

            try {

                // 初期化

                cameraProvider.unbindAll()

                // カメラを割り当て

                camera = cameraProvider.bindToLifecycle(this, cameraSelector, preview)

                // プレビューにカメラを設定

                preview?.setSurfaceProvider(viewFinder.createSurfaceProvider(camera?.cameraInfo))

            } catch (exc: Exception) {

                Log.e("MainActivity", "Use case binding failed", exc)

        }, ContextCompat.getMainExecutor(this))

これでアプリ上にカメラのプレビューが表示されるようになったはずです。

また、エミュレータ上のカメラは、Android Studio の ADV Manager の端末設定から変更することができ、仮想カメラを表示させることや、ホストマシン上のカメラを使用するように設定することもできます。右図は、ホストマシンのカメラを使用してアプリを起動した状態です。

文責若園 (2020.6.12)

Google Sites

Report abuse