Compartir a través de


MediaStreamSource Clase

Definición

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

public ref class MediaStreamSource sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Core.IMediaStreamSourceFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class MediaStreamSource final
/// [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.Activatable(typeof(Windows.Media.Core.IMediaStreamSourceFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class MediaStreamSource
[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
Implementaciones

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.

Se aplica a

Consulte también