Camera
Cameraウィジェットは、端末のカメラプレビューを画面にリアルタイムで表示するサーフェスです。
写真の撮影・動画の録画・フラッシュ・ズーム・フォーカス・露出などをスクリプトで制御できます。
定義・役割
Cameraウィジェットは、端末カメラのリアルタイムプレビューをレンダリングします。編集画面（デザインモード）ではプレースホルダーを表示し、アプリを実行すると実際のカメラプレビューが表示されます。レンズの向き・解像度・オーディオ・フラッシュ・撮影モードをプロパティで設定し、撮影・録画・保存をスクリプトで制御します。
- カテゴリー: Contents
- デフォルトサイズ: 横幅いっぱい × 高さ200
- デフォルトの撮影ボタン表示: オフ（
showCaptureButton = false）
機能
| 機能 | 説明 |
|---|---|
| リアルタイムプレビュー | 端末カメラの映像をリアルタイムで画面に表示します。（アプリ実行時） |
| 写真の撮影 | 現在のカメラで写真を撮影します。内蔵の撮影ボタン、またはスクリプトから実行します。 |
| 動画の録画 | 動画の録画を開始・停止・一時停止・再開します。 |
| カメラ設定 | レンズの向き・解像度・オーディオ・フラッシュ・撮影モードをプロパティで指定します。 |
| カメラ制御 | ズーム・フォーカス・露出・撮影方向のロックをスクリプトで調整します。 |
| ギャラリーへの保存 | 撮影したファイルやbase64画像を端末のギャラリーに保存します。 |
使い方
- 左側のウィジェットパレットでContentsカテゴリーを開きます。
- Camera項目をキャンバスにドラッグ&ドロップします。
- 右側のPropertiesパネルでレンズの向き（
lensFacing）・解像度（resolutionPreset）・撮影モード（captureMode）などを設定します。 - 内蔵の撮影ボタンを使う場合は
showCaptureButtonをオンにします。 - アプリを実行すると実際のカメラプレビューが表示されます。（編集画面ではプレースホルダーのみ表示）
プロパティ
| プロパティ | 説明 | デフォルト値 | 値 / タイプ |
|---|---|---|---|
lensFacing | 使用するカメラのレンズの向き | back（背面） | back, front |
resolutionPreset | プレビュー・撮影の解像度 | high | low, medium, high, veryHigh, ultraHigh, max |
enableAudio | 動画録画時にオーディオを含めるかどうか | オン（true） | true / false |
initialFlashMode | 初期のフラッシュモード | off | off, auto, always, torch |
captureMode | 撮影モード | photo | photo, video |
showCaptureButton | プレビュー上に内蔵の撮影ボタンを表示するかどうか | オフ（false） | true / false |
注意・ヒント
警告
実際のカメラプレビューは、アプリ実行時（実機）にのみ表示されます。編集画面（デザインモード）では、カメラのアイコンと案内文が入ったプレースホルダーのみが表示されます。
注記
カメラと保存の権限が必要です。Androidで写真や動画をギャラリーに保存するには、写真（またはストレージ）の権限が許可されている必要があります。
さらに詳しく
ヒント
このウィジェットをスクリプトで制御するWidget Control（Property・Method・Event）の全体はCamera Widget Controlドキュメントで確認してください。