AppCaptureMetadataWriter Classe

Definizione

public ref class AppCaptureMetadataWriter sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Media.Capture.AppCaptureMetadataContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Media.Capture.AppCaptureMetadataContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppCaptureMetadataWriter final : IClosable

[Windows.Foundation.Metadata.Activatable(65536, "Windows.Media.Capture.AppCaptureMetadataContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Media.Capture.AppCaptureMetadataContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppCaptureMetadataWriter : System.IDisposable

function AppCaptureMetadataWriter()

Public NotInheritable Class AppCaptureMetadataWriter
Implements IDisposable

Ereditarietà

Object Platform::Object IInspectable AppCaptureMetadataWriter

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

Requisiti Windows

Commenti

Quando si crea un'istanza di AppCaptureMetadataWriter, il sistema inizializza un'istanza univoca per l'app ed è quindi pronta per la scrittura di elementi di metadati. Anche se è possibile acquisire o trasmettere una sola app alla volta, il sistema può accumulare metadati per più app contemporaneamente. AppCaptureMetadataWriter non avvia o modifica lo stato di acquisizione o trasmissione corrente. È consigliabile creare e conservare l'istanza di AppCaptureMetadataWriter purché il sistema contenga i metadati in memoria. Quando viene rilasciata l'istanza di AppCaptureMetadataWriter , vengono rilasciati anche tutti i metadati associati a tale istanza di AppCaptureMetadataWriter .

Quando si scrive un elemento di metadati, il sistema associa un timestamp all'elemento in modo che venga automaticamente incluso nell'intervallo di tempo acquisito o trasmesso a cui si applica.

Attualmente sono supportati due tipi diversi di elementi di metadati AppCaptureMetadataWriter: eventi e stato. Un evento di metadati è associato a un singolo punto nel tempo e in genere è associato a un'azione istantanea, ad esempio un giocatore in un gioco che segna un punto. Uno stato è un elemento di metadati che si applica in un intervallo di tempo. Un esempio è uno stato che contiene il nome della mappa di gioco in cui è attualmente presente un giocatore. Dopo aver impostato un valore di stato, il sistema mantiene tale valore per lo stato finché non viene impostato su un valore diverso, fino a quando non viene arrestato con una chiamata StopState o finché tutti gli stati non vengono terminati con una chiamata a StopAllStates. Entrambi gli eventi e gli stati sono rappresentati come coppia chiave/valore in cui la chiave è il nome dello stato o dell'evento e il valore è un numero intero, un valore double o un valore stringa.

Quando l'acquisizione di app cronologiche è abilitata, il sistema accumula metadati scritti con AppCaptureMetadataWriter anche quando non acquisisce o trasmette attivamente. Quando, ad esempio, un'acquisizione dei 30 secondi precedenti viene scritta in un file video su disco, i metadati associati all'intervallo di tempo registrato vengono inclusi nel file. Il sistema impone un limite allo spazio di archiviazione allocato per ogni app per l'archiviazione dei metadati accumulati. È possibile ottenere lo spazio di archiviazione attualmente disponibile controllando la proprietà RemainingStorageBytesAvailable .

Quando tutto lo spazio assegnato è stato riempito, il sistema inizierà a ripulire i metadati usando il valore AppCaptureMetadataPriority , specificato quando sono stati scritti gli elementi di metadati e l'età di ogni elemento per eliminare prima i dati meno recenti e meno importanti. In questo caso, viene generato l'evento MetadataPurged . In risposta a questo evento, è possibile scegliere di ridurre la quantità di metadati che l'app sta scrivendo, ma non è necessaria.

Gli elementi di metadati vengono classificati come Importanti o Informativi come specificato con l'enumerazione AppCaptureMetadataPriority . Priorità importante significa che i metadati verranno caricati nel servizio Xbox Live. I metadati verranno usati per aiutare gli utenti a cercare clip o annotare le trasmissioni, tra le altre cose. Sia i metadati importanti che i metadati informativi sono incorporati nel file di .mp4 generato, pertanto non è consigliabile includere informazioni utente private nei metadati.

Questa API può generare un errore se il servizio in background è stato arrestato a causa del timeout di inattività.

Costruttori

Proprietà

Metodi

Eventi

Si applica a