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 在当前时间开始应用录制。