CameraCaptureUI クラス

定義

名前空間:

Windows.Media.Capture

カメラからオーディオ、ビデオ、写真をキャプチャするためのフル ウィンドウ UI を提供します。 ビデオのトリミング、遅延キャプチャ、カメラ設定のコントロールも含まれます。

public ref class CameraCaptureUI sealed

/// [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.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 CameraCaptureUI

function CameraCaptureUI()

Public NotInheritable Class CameraCaptureUI

継承

Object Platform::Object IInspectable CameraCaptureUI

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 ユーザー インターフェイスを起動します。

こちらもご覧ください

• オーディオ、ビデオ、およびカメラ
• Windows の組み込みカメラ UI を使った写真とビデオのキャプチャ