AppRecordingManager.RecordTimeSpanToFileAsync メソッド

定義

名前空間:

Windows.Media.AppRecording

指定した開始時刻と期間で定義された時間範囲を持つ履歴バッファーから、現在のアプリのオーディオとビデオのコンテンツを、指定した宛先ファイルに書き込みます。

public:
 virtual IAsyncOperation<AppRecordingResult ^> ^ RecordTimeSpanToFileAsync(DateTime startTime, TimeSpan duration, StorageFile ^ file) = RecordTimeSpanToFileAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<AppRecordingResult> RecordTimeSpanToFileAsync(DateTime const& startTime, TimeSpan const& duration, StorageFile const& file);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<AppRecordingResult> RecordTimeSpanToFileAsync(System.DateTimeOffset startTime, System.TimeSpan duration, StorageFile file);

function recordTimeSpanToFileAsync(startTime, duration, file)

Public Function RecordTimeSpanToFileAsync (startTime As DateTimeOffset, duration As TimeSpan, file As StorageFile) As IAsyncOperation(Of AppRecordingResult)

パラメーター

startTime

DateTime DateTimeOffset

記録するコンテンツが開始された時刻。 この値は、履歴バッファーの期間内である必要があります。これは、 AppRecordingManager.GetStatus を呼び出し、 AppRecordingStatus.HistoricalBufferDuration プロパティの値を確認することによって決定できます。

duration

TimeSpan TimeSpan

アプリの記録の要求された期間。 アプリの記録は成功しますが、記録用に割り当てられたストレージに達した場合は、このパラメーターで指定したよりも短い期間を記録します。 実際に記録されたファイルの期間を確認するには、この操作から返されたオブジェクトの値 AppRecordingResult.Duration プロパティをチェックします。

file

StorageFile

記録されたメディアの書き込み先のファイル。

戻り値

IAsyncOperation<AppRecordingResult>

完了時に AppRecordingResult オブジェクトを 返す非同期操作。このオブジェクトには、記録操作の状態に関する情報が含まれます。

属性

RemoteAsyncAttribute

注釈

アプリの記録を含む保存されたファイルは、h.264 ビデオと AAC オーディオを備えた MP4 として作成されます。 AppRecordingManager を使用して記録されたビデオ ファイルは、GameDVR や XBox アプリなどのファースト パーティエクスペリエンスには取り込まれません。

このメソッドを呼び出す前に、GetStatus を呼び出し、CanRecordTimeSpan の値をチェックして、現在のアプリでタイム スパンの記録を行うことができるかどうかを確認します。

StartRecordingToFileAsync を使用して、現在の時刻にアプリの記録を開始します。