目次 - SDL 3.0 API(機能別) - ビデオキャプチャ - SDL_CameraID

SDL_GetCameraPermissionState

ユーザによるカメラの使用許可状態をチェックする

ヘッダ

SDL3/SDL_camera.h

構文

SDL_CameraPermissionState SDL_GetCameraPermissionState(SDL_Camera *camera);

引数

SDL_Camera *cameraオープンしたカメラデバイス

戻り値

(SDL_CameraPermissionState) 確定しているときカメラのアクセス許可状態を戻す. 保留中のときSDL_CAMERA_PERMISSION_STATE_PENDINGを戻す.

詳細

カメラは, アプリケーションのデバイスのオープンと, ユーザのハードウェアへのアクセスの許可の間は, 機能しない. 一部の環境では, ここでポップアップダイアログを表示して明示的にユーザにアクセス許可を求める.

この関数はアクセス許可状態をチェックするために使用できる. ユーザの応答を待っている間はSDL_CAMERA_PERMISSION_STATE_PENDINGを戻し, カメラの使用を許可したならばSDL_CAMERA_PERMISSION_STATE_APPROVEDを, 拒否したならばSDL_CAMERA_PERMISSION_STATE_DENIEDを戻す.

この関数によるポーリングではなく, 標準のSDLイベントループからSDL_EVENT_CAMERA_DEVICE_APPROVED(またはSDL_EVENT_CAMERA_DEVICE_DENIED)イベントを待つこともできる. これはカメラの使用許可が決まったとき一度だけ送信されることが保証されている.

カメラの使用を拒否された場合, 何も行われないがSDL_CloseCamera()で破棄する必要はある.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetCameraPermissionState - SDL Wiki