AppRecordingManager.RecordTimeSpanToFileAsync Methode

Definition

Namespace:

Windows.Media.AppRecording

Schreibt Audio- und Videoinhalte der aktuellen App aus dem Verlaufspuffer mit einem durch die angegebene Startzeit und Dauer definierten Zeitbereich in die angegebene Zieldatei.

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)

Parameter

startTime

DateTime DateTimeOffset

Der Zeitpunkt, zu dem der aufzuzeichnende Inhalt gestartet wurde. Dieser Wert muss sich innerhalb der Dauer des Verlaufspuffers befinden, der durch Aufrufen von AppRecordingManager.GetStatus und anschließendes Überprüfen des Werts der Eigenschaft AppRecordingStatus.HistoricalBufferDuration bestimmt werden kann.

duration

TimeSpan TimeSpan

Die angeforderte Dauer der App-Aufzeichnung. Eine App-Aufzeichnung kann erfolgreich sein, zeichnet jedoch eine kürzere Dauer als mit diesem Parameter angegeben auf, wenn der zugeordnete Speicher für Aufzeichnungen erreicht ist. Um die Dauer der tatsächlich aufgezeichneten Datei zu bestimmen, überprüfen Sie den Wert AppRecordingResult.Duration-Eigenschaft des von diesem Vorgang zurückgegebenen Objekts.

file

StorageFile

Die Datei, in die das aufgezeichnete Medium geschrieben wird.

Gibt zurück

IAsyncOperation<AppRecordingResult>

Ein asynchroner Vorgang, der nach Abschluss ein AppRecordingResult-Objekt zurückgibt, das Informationen über die status des Aufzeichnungsvorgangs enthält.

Attribute

RemoteAsyncAttribute

Hinweise

Die gespeicherte Datei mit der App-Aufzeichnung wird als MP4 mit h.264-Video und AAC-Audio erstellt. Videodateien, die mit AppRecordingManager aufgezeichnet wurden, werden nicht in Erstanbietererfahrungen wie GameDVR oder der XBox-App erfasst.

Rufen Sie vor dem Aufrufen dieser Methode GetStatus auf, und überprüfen Sie den Wert von CanRecordTimeSpan , um zu ermitteln, ob die aktuelle App derzeit in der Lage ist, eine Zeitspannenaufzeichnung zu erstellen.

Verwenden Sie StartRecordingToFileAsync , um eine App-Aufzeichnung zur aktuellen Zeit zu starten.