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 開始在目前時間錄製應用程式。