CameraCaptureUI クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カメラからオーディオ、ビデオ、写真をキャプチャするためのフル ウィンドウ UI を提供します。 ビデオのトリミング、遅延キャプチャ、カメラ設定のコントロールも含まれます。
public ref class CameraCaptureUI sealed/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
class CameraCaptureUI final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CameraCaptureUI final[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
public sealed class CameraCaptureUI[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraCaptureUIfunction CameraCaptureUI()Public NotInheritable Class CameraCaptureUI- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
| アプリの機能 |
microphone
webcam
|
例
このコードは、 CameraCaptureUI クラスを使用して写真を撮る方法を示しています。 このコードは、 カメラ キャプチャ UI C# サンプルの CapturePhoto.xaml.cs ファイルからのコードです。 同等の カメラ キャプチャ UI C++ サンプル も使用できます。 非同期メソッド CaptureFileAsync を呼び出すと、ユーザーとのダイアログが表示されます。
// Using Windows.Media.Capture.CameraCaptureUI API to capture a photo
CameraCaptureUI dialog = new CameraCaptureUI();
Size aspectRatio = new Size(16, 9);
dialog.PhotoSettings.CroppedAspectRatio = aspectRatio;
StorageFile file = await dialog.CaptureFileAsync(CameraCaptureUIMode.Photo);
注釈
CameraCaptureUI は、オーディオ、ビデオ、画像をキャプチャするためのフル ウィンドウ UI エクスペリエンスを提供します。 写真のキャプチャ、ビデオのトリミング、ビデオの解像度、オーディオ デバイス、明るさ、コントラストなどのカメラの設定を調整するためのコントロールを提供します。
CaptureFileAsync を呼び出して UI を起動します。 ユーザーは、キャプチャを開始するタイミングを制御できます。 非同期 CaptureFileAsync 操作が完了すると、 StorageFile オブジェクトが返されます。 CameraCaptureUI を使用する方法については、「Windows 組み込みのカメラ UI を使用して写真とビデオをキャプチャする」を参照してください。
Note
CameraCaptureUI を使用している場合は、アプリ マニフェスト ファイルで Web カメラまたはマイクの機能を指定しないでください。 そうすると、アプリはデバイスのカメラ プライバシー設定に表示されますが、ユーザーがアプリへのカメラ アクセスを拒否しても、 CameraCaptureUI がメディアをキャプチャできなくなります。 これは、Windows の組み込みのカメラ アプリが、写真、音声、ビデオのキャプチャをボタンを押して開始する必要がある、信頼されているファースト パーティ アプリであるためです。 CameraCaptureUI を使用するときに Web カメラまたはマイクの機能を指定した場合、ストアに送信すると、アプリが Windows アプリケーション認定キットの認定に失敗する可能性があります。
MediaCapture を使用してオーディオ、写真、またはビデオをプログラムでキャプチャする場合は、アプリ マニフェスト ファイルで Web カメラまたはマイク機能を指定する必要があります。
Note
このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「スレッド処理とマーシャリング (C++/CX)」および「マルチスレッド環境での Windows ランタイム オブジェクトの使用 (.NET)」を参照してください。
コンストラクター
| CameraCaptureUI() |
新しい CameraCaptureUI オブジェクトを 作成します。 |
プロパティ
| PhotoSettings |
写真をキャプチャするための設定を提供します。 設定には、縦横比、画像サイズ、形式、解像度、およびユーザー インターフェイス (UI) でトリミングを許可するかどうかが含まれます。 |
| VideoSettings |
ビデオをキャプチャするための設定を提供します。 設定には、形式、最大解像度、最大期間、トリミングを許可するかどうかが含まれます。 |
メソッド
| CaptureFileAsync(CameraCaptureUIMode) |
CameraCaptureUI ユーザー インターフェイスを起動します。 |