ユーザーがデバイス上のカメラを使用して写真を撮ることを可能にするコントロール。
Description
カメラ コントロールを使用して、デバイスのカメラで画像をキャプチャします。 デバイスにはカメラが必要であり、ユーザーはカメラを使用するアプリを承認する必要があります。
カメラ コントロールを選択して、カメラから画像をキャプチャします。
最近キャプチャした画像は、 Photo プロパティを使用して使用できます。 このプロパティを使用すると、イメージは次のようになります。
- Image コントロールで表示されます。 Image コントロールを使用して、キャプチャされたイメージを表示します。 詳細については、 例を参照してください。
- 変数またはコレクションに一時的に配置します。 Set 関数または Collect 関数を使用して、変数またはコレクションにイメージを格納します。 1 つのコレクションで複数のイメージを同時に使用すると、デバイスのメモリが制限される場合は注意が必要です。 SaveData 関数と LoadData 関数を使用して、デバイス上のローカル ストレージにイメージを移動し、オフラインのシナリオで使用します。
- データベースに格納されます。 Patch 関数を使用して、イメージをデータベースに格納します。
- base64 でエンコードされたテキスト文字列として送信されます。 JSON 関数を使用して、base64 でイメージをエンコードします。
Stream、StreamRate、OnStream の各プロパティを使用して、タイマーで画像を自動的にキャプチャします。たとえば、1 分ごとに画像をスナップしてタイムラプス シーケンスを作成します。
キャプチャされたメディアは、テキスト文字列 URI によって参照されます。 詳細については、 データ型のドキュメントを参照してください。
注
- カメラ コントロールは、Microsoft Edge、Chrome、Firefox、Opera ブラウザーでのみサポートされています。および Android および iOS デバイス。 他のすべてのブラウザーとプラットフォームでは、アプリの一部の機能が機能しないという警告が表示されます。
- カメラ コントロールによって生成される画像の最大解像度は 640 x 480 px です。 完全解像度の画像が必要な場合は、代わりに [画像の追加] コントロールを使用します。
- モバイル デバイスのメイクとモデルによっては、カメラ コントロールを使用する場合、デバイス のカメラの初期化に数秒かかる場合があります。
制限事項
カメラ コントロールには、次の制限があります。
- カメラ コントロールを使用する場合、画像にはメタデータ情報が含まれません。 これは、カメラで画像を撮影する方法の制限によるものです。 この問題を軽減するには、[画像の追加] コントロールを使用します。
- モバイル デバイスのメモリが不足している場合は、デバイスのクラッシュを回避するためにカメラが一時的に無効になります。
- カメラ コントロールを使用するアプリを開くと、Power Apps for Windows がクラッシュする可能性があります。 この問題を回避するには、Windows プラットフォームで Web プレーヤーを使用します。 また、複数のカメラはサポートされていません。
重要なプロパティ
AvailableDevices – デバイスで使用可能なカメラの表。
テーブルには、次の 2 つの列があります。
- Camera プロパティで使用する ID 番号
- カメラを識別するためにデバイスによって提供される名前。 一部のプラットフォームには、カメラを見つけるのに役立つ Front または Back が含まれる場合があります。
注: テーブル内のすべてのデバイスがアプリで使用できるわけではありません。 一部は、特定の目的を目的とした特殊なドライバーまたはアプリケーションである場合があります。
カメラ – 使用するカメラの数値 ID。 複数のカメラを搭載したデバイスに役立ちます。
OnStream – Stream プロパティが更新されたときに実行するアクション。
写真 – ユーザーが写真を撮ったときにキャプチャされた画像。
Stream – StreamRate プロパティに基づいてイメージを自動的に更新します。
StreamRate – Stream プロパティのイメージを更新する頻度 (ミリ秒単位)。 この値の範囲は 100 (秒の 1/10) から 3,600,000 (1 時間) です。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。 写真を撮る目的を説明する必要があります。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
明るさ – ユーザーが画像内で認識する可能性が高い光の量。
コントラスト – ユーザーが画像内の類似した色をどの程度簡単に区別できるか。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
Height – コントロールの上端と下端の間の距離。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
TabIndex – 他のコントロールと比較したキーボード ナビゲーション順序。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端と、その親コンテナーまたは画面の左端との間の距離。
Y – コントロールの上端と親コンテナーまたは画面の上端との間の距離。
例示
これらの例では、カメラ付きのデバイスが必要です。 アプリをテストするには、ブラウザーからアクセスできる Web カムを使用します。 または、アプリを保存し、カメラを使用して iOS または Android デバイスに読み込みます。
キャプチャした画像のシンプルな表示
カメラ コントロールを追加します。
メッセージが表示されたら、アプリがデバイスのカメラを使用することを承認します。
イメージ コントロールを追加します。
Image コントロールの Image プロパティを次の式に設定します。
Camera1.Photo注
カメラ コントロール名 Camera1 を適宜置き換えます。
F5 キーを押してアプリをプレビューします。
カメラ コントロールを選択またはタップして、写真を撮ります。 結果が画像コントロールに表示されます。
イメージ ギャラリー コントロールに画像を追加する
カメラ コントロールを追加し、MyCamera という名前を付け、その OnSelect プロパティを次の数式に設定します。
Collect( MyPix, MyCamera.Photo )詳細については、以下を参照してください。
- コントロールを追加、名前付け、構成する方法
- 関数またはその他の関数の収集について詳しくは、こちらをご覧ください。
F5 キーを押し、 MyCamera を選択またはタップして写真を撮ります。
垂直ギャラリー コントロールを追加します。 次に、 Image コントロール、テンプレート、および イメージ ギャラリー コントロール自体のサイズを、画面に収まるようにサイズ変更します。
イメージ ギャラリー コントロールの Items プロパティを次の数式に設定します。
MyPixギャラリーの Image コントロールの Image プロパティを次の数式に設定します。
ThisItem.Url撮影した画像が イメージ ギャラリー コントロールに表示されます。
必要な数の画像を撮影し、Esc キーを押して既定のワークスペースに戻ります。
(省略可能)イメージ ギャラリー コントロールの Image コントロールの OnSelect プロパティを数式に設定します。
Remove( MyPix, ThisItem )F5 キーを押し、画像を選択して削除します。
SaveData 関数を使用して画像をローカルに保存するか、Patch 関数を使用してデータ ソースを更新します。
アクティブなカメラをドロップダウンから変更する
カメラ コントロールを追加します。
メッセージが表示されたら、アプリがデバイスのカメラを使用することを承認します。
ドロップダウンの Items プロパティを次のように設定します。
Camera1.AvailableDevices注
カメラ コントロール名 Camera1 を適宜置き換えます。
カメラの Camera プロパティを次の値に設定します。
Dropdown1.Selected.Id注
ドロップダウン コントロール名 Dropdown1 を適宜置き換えます。
F5 キーを押し、ドロップダウンから項目を選択してカメラを変更します。
アクセシビリティ ガイドライン
カメラ コントロールにはカメラ フィードが表示され、写真を撮影するボタンとしても機能します。 そのため、ボタンと同様のアクセシビリティに関する考慮事項があります。
ビデオの代替手段
視覚障なるユーザーに代わりの入力形式を追加することを検討してください。 たとえば、 画像を追加 して、ユーザーがデバイスから画像をアップロードできるようにします。
色のコントラスト
FocusedBorderColor と外側の色の間には、適切な色のコントラストが必要です。
スクリーン リーダーのサポート
AccessibleLabel が存在する必要があります。
キーボードのサポート
キーボード ユーザーが移動できるようにするには、TabIndex を 0 以上にする必要があります。
フォーカス インジケーターは明確に表示する必要があります。 FocusedBorderColor と FocusedBorderThickness を使用して、フォーカス インジケーターの可視性を更新します。