MediaStreamSource Clase

Definición

Espacio de nombres:

Windows.Media.Core

Representa un origen multimedia que entrega ejemplos multimedia directamente a la canalización de medios.

public ref class MediaStreamSource sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Core.IMediaStreamSourceFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class MediaStreamSource final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.Core.IMediaStreamSourceFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaStreamSource

function MediaStreamSource(descriptor, descriptor2)

Public NotInheritable Class MediaStreamSource

Herencia

Object Platform::Object IInspectable MediaStreamSource

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IMediaSource

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Consulta el ejemplo mediaStreamSource para obtener un ejemplo de cómo usar el origen de flujo multimedia en una aplicación para UWP.

MediaStreamSource es un nuevo origen multimedia genérico para aplicaciones para UWP que se introduce en Windows 8.1. MediaStreamSource permite a las aplicaciones enviar muestras de audio y vídeo comprimidas o sin comprimir a la canalización multimedia para la reproducción, la transcodificación y el streaming. Los ejemplos multimedia se pueden generar dinámicamente mediante la aplicación o des multiplexados desde una secuencia o archivos. Esta flexibilidad permite a las aplicaciones ampliar más fácilmente la compatibilidad con la plataforma para nuevos formatos multimedia o resolver problemas complejos, como el streaming adaptable.

MediaStreamSourceAPI es muy similar a Microsoft SilverlightAPI con el mismo nombre.

MediaStreamSource se puede usar con objetos de audio y vídeo en la aplicación de Windows mediante JavaScript, objetos MediaElement en aplicaciones para UWP con C++, C# o Visual Basic y MediaTranscoder.

El ejemplo MediaStreamSource muestra cómo usar MediaStreamSource. Estas son algunas de las PRINCIPALES API de MediaStreamSource. El orden describe el flujo básico de cómo funciona MediaStreamSource. Observará que MediaStreamSource envía objetos de solicitud a la aplicación a través de argumentos de evento. Estos objetos de solicitud permiten a la aplicación interactuar con MediaStreamSource y devolver datos a ella.

API	Descripción
MediaStreamSource	Representa un origen multimedia que entrega ejemplos multimedia directamente a la canalización de medios. MediaStreamSource consume objetos MediaStreamSample proporcionados por la aplicación.
MediaStreamSample	Representa un ejemplo multimedia utilizado por MediaStreamSource.
MediaStreamSource.Starting (evento)	MediaStreamSource usa este evento para notificar a la aplicación que está lista para iniciar el procesamiento de datos multimedia.
MediaStreamSourceStartingRequest	Representa una solicitud de MediaStreamSource que está lista para iniciar el procesamiento de datos multimedia. Las aplicaciones deben responder lo antes posible a esta solicitud mediante una llamada a SetActualStartPosition en la solicitud. Si una aplicación necesita retrasar mediaStreamSource de procesar datos, puede obtener un aplazamiento asincrónico de MediaStreamSourceStartingRequest.GetDeferral. Cuando la aplicación esté lista para que mediaStreamSource se inicie, llama a Complete en el objeto de aplazamiento. Se obtiene acceso a la solicitud inicial a través del controlador de eventos MediaStreamSourceStartingEventArgs que se pasan al controlador de eventos MediaStreamSource.Starting .
MediaStreamSource.SampleRequested (evento)	MediaStreamSource usa este evento para notificar a la aplicación que está lista para mediaStreamSample. Las aplicaciones son necesarias para registrar un controlador para este evento.
MediaStreamSourceSampleRequest	Representa una solicitud de MediaStreamSource para un nuevo ejemplo multimedia. Al establecer la propiedad Sample en el nuevo objeto MediaStreamSample , se desencadena MediaStreamSource para recuperar el ejemplo multimedia y continuar procesando los datos multimedia. Las aplicaciones deben responder lo antes posible a esta solicitud. Si una aplicación necesita tiempo antes de enviar MediaStreamSample, puede obtener un aplazamiento asincrónico de MediaStreamSourceSampleRequest.GetDeferral. Cuando la aplicación finaliza con el aplazamiento, llama a Complete en el objeto de aplazamiento. Se obtiene acceso a la solicitud de ejemplo a través del controlador de eventos MediaStreamSourceSampleRequestedEventArgs que se pasan al controlador de eventos MediaStreamSource.SampleRequest . La aplicación indica que ha llegado al final de la secuencia respondiendo a una clase MediaStreamSourceSampleRequest sin proporcionar un objeto MediaStreamSample o asignando la propiedad MediaStreamSourceSampleRequest.Sample a null.
MediaStreamSource.Closed (evento)	MediaStreamSource usa este evento para notificar a la aplicación que se ha cerrado.
MediaStreamSourceClosedRequest	Representa una solicitud de MediaStreamSource que ha cerrado. Se obtiene acceso a la solicitud de cierre a través del mediaStreamSourceClosedEventArgs que se pasa al controlador de eventos MediaStreamSource.Closed .
MediaElement.SetMediaStreamSource	Establece el origen de MediaElement en un objeto MediaStreamSource.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	SampleRendered
1703	15063	MaxSupportedPlaybackRate
1709	16299	IsLive

Constructores

MediaStreamSource(IMediaStreamDescriptor)	Crea una instancia de MediaStreamSource a partir del IMediaStreamDescriptor especificado.
MediaStreamSource(IMediaStreamDescriptor, IMediaStreamDescriptor)	Crea una instancia de MediaStreamSource a partir de dos objetos IMediaStreamDescriptor .

Propiedades

BufferTime	Obtiene o establece la cantidad de datos almacenados en búfer por MediaStreamSource.
CanSeek	Obtiene o establece si la aplicación admite o no cambiar su posición en la línea de tiempo multimedia.
Duration	Obtiene o establece la duración de la línea de tiempo multimedia.
IsLive	Obtiene o establece un valor que indica si el contenido multimedia que se está procesando está activo.
MaxSupportedPlaybackRate	Obtiene la velocidad de reproducción admitida de maxiumum para MediaStreamSource.
MediaProtectionManager	Obtiene o establece el Objeto MediaProtectionManager de Administración de derechos digitales (DRM) que se usa para proteger los medios.
MusicProperties	Obtiene las propiedades de música que se usan para los metadatos relacionados con la música.
Thumbnail	Obtiene o establece la miniatura que es una referencia a una secuencia de una imagen en miniatura de vídeo o una imagen de álbum de música.
VideoProperties	Obtiene las propiedades de vídeo que se usan para los metadatos relacionados con vídeos.

Métodos

AddProtectionKey(IMediaStreamDescriptor, Byte[], Byte[])	Agrega una clave de protección de Administración de derechos digitales (DRM) que usa MediaProtectionManager para cifrar y descifrar la secuencia especificada.
AddStreamDescriptor(IMediaStreamDescriptor)	Agrega un nuevo descriptor de secuencia a MediaStreamSource.
NotifyError(MediaStreamSourceErrorStatus)	Notifica a MediaStreamSource que se ha producido un error que impide que la aplicación siga entregando datos a MediaStreamSource.
SetBufferedRange(TimeSpan, TimeSpan)	Establece el intervalo de datos que la aplicación está almacenando en búfer actualmente.

Eventos

Closed	Se produce cuando mediaStreamSource se apaga.
Paused	Se produce cuando MediaStreamSource está en pausa y deja de solicitar objetos MediaStreamSample durante un período de tiempo no especificado, pero se espera que reanude la solicitud de objetos MediaStreamSample desde la posición actual.
SampleRendered	Se produce cuando se representa un ejemplo de MediaStreamSource .
SampleRequested	Se produce cuando MediaStreamSource solicita una clase MediaStreamSample para una secuencia especificada.
Starting	Se produce cuando MediaStreamSource está listo para iniciar la solicitud de objetos MediaStreamSample . El evento puede especificar una posición en la línea de tiempo multimedia desde la que se debe entregar el primer MediaStreamSample .
SwitchStreamsRequested	Se produce cuando MediaStreamSource dejará de solicitar objetos MediaStreamSample para una secuencia determinada y comenzará a solicitar objetos MediaStreamSample desde una secuencia diferente en su lugar.

Consulte también

• IMediaSource
• Ejemplo de MediaStreamSource