カメラの設定

ArCameraConfig では、次のような、基盤となるカメラセンサーのプロパティについて説明します。

カメラ ID
深度センサーが使用されるかどうか（使用可能な場合）
カメラの向き:
- 正面（自撮り）
- 背面（ワールド）
FPS（フレーム/秒）の範囲
CPU イメージのサイズ
GPU テクスチャの次元
存在する場合、デバイスのステレオマルチカメラを使用するかどうか

新しい ARCore セッションを作成する際、ARCore は ArSession_setCameraConfig() を使用して、ArSession_getSupportedCameraConfigsWithFilter() から返される利用可能な設定のリストに最適なカメラ設定を設定します。アプリでは、ArCameraConfigFilter を使用してアプリのニーズに基づいてフィルタリングすることで、実行時に特定のデバイスで使用可能なカメラ構成を絞り込むことができます。

フィルタリングの一般的な使用例は次のとおりです。

カメラのキャプチャフレームレートを 30 fps に制限する。60 fps をサポートするデバイスでは、ARCore はそのフレームレートをサポートするカメラ設定を優先します。60 fps をサポートするすべてのカメラ構成を除外するには、AR_CAMERA_CONFIG_TARGET_FPS_30 を使用して ArCameraConfigFilter_setTargetFps() でフィルタを適用します。
```
// Return only camera configs that target 30 FPS camera capture frame
// rate.
ArCameraConfigFilter_setTargetFps(session, filter,
                                  AR_CAMERA_CONFIG_TARGET_FPS_30);
```
ARCore が奥行きセンサーを使わないようにするサポートされている深度センサーを搭載したデバイスでは、ARCore は奥行きセンサーを使用するカメラ構成を優先します。奥行きセンサーを使用するすべてのカメラ構成を除外するには、AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE を使用して ArCameraConfigFilter_setDepthSensorUsage() フィルタを適用します。
```
ArCameraConfigFilter_setDepthSensorUsage(
    session, filter, AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE);
```
代替 GPU テクスチャ解像度の選択サポートされているデバイスでは、ARCore によって追加の GPU テクスチャ解像度が提供される場合があります。低解像度の GPU テクスチャを選択すると、GPU の負荷が軽減され、メモリ帯域幅の要件が軽減されるため、アプリのパフォーマンスを改善できる可能性があります。ただし、すべてのケースでパフォーマンスが向上するとは限りません。

カメラ構成フィルタの使用

アプリでカメラ構成をフィルタできるようにするには、次の手順を行います。

// Create an ARCore session.
ArSession* session;
ArSession_create(env, context, &session);

// Create a camera config list and filter for the session.
ArCameraConfig* selected_config;
ArCameraConfigList* configs;
ArCameraConfigFilter* filter;
ArCameraConfig_create(session, &selected_config);
ArCameraConfigList_create(session, &configs);
ArCameraConfigFilter_create(session, &filter);

// Return only camera configs that target 30 fps camera capture frame rate.
ArCameraConfigFilter_setTargetFps(session, filter,
                                  AR_CAMERA_CONFIG_TARGET_FPS_30);

// Return only camera configs that will not use the depth sensor.
ArCameraConfigFilter_setDepthSensorUsage(
    session, filter, AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE);

// Get list of configs that match filter settings.
// In this case, this list is guaranteed to contain at least one element,
// because both TargetFps.TARGET_FPS_30 and DepthSensorUsage.DO_NOT_USE
// are supported on all ARCore supported devices.
ArSession_getSupportedCameraConfigsWithFilter(session, filter, configs);

// Use element 0 from the list of returned camera configs. This is because
// it contains the camera config that best matches the specified filter
// settings.
ArCameraConfigList_getItem(session, configs, 0, selected_config);

// Set the camera config to use selected_config.
ArSession_setCameraConfig(session, selected_config);

// Free memory.
ArCameraConfigFilter_destroy(filter);
ArCameraConfigList_destroy(configs);

フォーカスモード

セッション構成でフォーカスモードを設定することもできます。固定フォーカスは、一般的にトラッキングに適しています（ほとんどのデバイスで ARCore のデフォルトです）。記録、写真撮影、動画撮影、近くの物体へのフォーカスが必要な場合は、オートフォーカスが必要になります。

詳しくは、ArConfig_setFocusMode() をご覧ください。

カメラの設定

カメラ構成フィルタの使用

フォーカス モード

フォーカスモード