次の方法で共有


CameraCaptureUI クラス

定義

カメラからオーディオ、ビデオ、写真をキャプチャするためのフル ウィンドウ 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 CameraCaptureUI
function CameraCaptureUI()
Public NotInheritable Class CameraCaptureUI
継承
Object Platform::Object IInspectable 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 ユーザー インターフェイスを起動します。

適用対象

こちらもご覧ください