Fonte de mídia ASF
O Media Foundation fornece a fonte de mídia ASF que um aplicativo pode usar para representar um arquivo ASF na camada de pipeline da arquitetura.
Para reproduzir um arquivo ASF, um aplicativo pode usar a fonte de mídia ASF para alimentar dados em um pipeline de reprodução. Em um cenário de codificação, o aplicativo pode usar a fonte de mídia ASF como a origem para converter em outro formato ou para converter um arquivo de taxa de bits mais alta em um arquivo de taxa de bits mais baixa sem alterar formatos. A fonte de mídia ASF deve ser usada na camada de pipeline, ou seja, um aplicativo deve usar a Sessão de Mídia para controlar a operação. Esse nível de acesso permite que os aplicativos obtenham eventos enquanto a Sessão de Mídia está em andamento. Para obter acesso de nível inferior ao conteúdo do ASF, um aplicativo deve usar os componentes asf da camada WMContainer.
A fonte de mídia ASF implementa a interface IMFMediaSource , que é a interface genérica para fontes de mídia no Media Foundation. Como qualquer outra fonte de mídia, a fonte de mídia ASF fornece um descritor de apresentação que descreve principalmente o objeto de cabeçalho ASF. Além disso, a fonte de mídia ASF fornece descritores de fluxo que representam cada fluxo no conteúdo de mídia. Para obter mais informações, consulte Estrutura de Arquivos ASF.
- Criando a fonte de mídia ASF
- Configurações para a fonte de mídia ASF
- Modelo de objeto de origem de mídia ASF
- Serviços de Origem de Mídia do ASF
- Tópicos relacionados
Criando a fonte de mídia ASF
Para criar a fonte de mídia ASF, o aplicativo deve usar o Resolvedor de Origem. Para criar a fonte de mídia ASF, o aplicativo deve fornecer a origem para a qual o resolvedor de origem cria a fonte de mídia ASF. As informações de origem devem ser fornecidas especificando a URL do arquivo de origem ou o fluxo de bytes que contém a mídia. Se o aplicativo optar por criar a fonte de mídia ASF especificando a URL, ele deverá chamar IMFSourceResolver::CreateObjectFromURL para operação síncrona ou IMFSourceResolver::Begin... EndCreateObjectFromURL para operação assíncrona. O processo para criar a fonte de mídia de um fluxo de bytes é semelhante. O aplicativo deve chamar IMFSourceResolver::CreateObjectFromByteStream para operação síncrona ou IMFSourceResolver::Begin... EndCreateObjectFromBytestream para operação assíncrona. Essas chamadas devem especificar MF_RESOLUTION_MEDIASOURCE no parâmetro dwFlags . Para obter mais informações sobre como usar esse sinalizador, consulte Usando o Resolvedor de Origem.
Se o aplicativo especificar uma URL, para um arquivo local, a cadeia de caracteres de URL poderá conter o caminho do arquivo de mídia ou pode ser prefixada com o "arquivo: "scheme". A extensão de nome de arquivo deve ser ".asf", ".wm", L".wma" ou ".wmv". Para um arquivo ASF na rede, o resolvedor de origem cria a Fonte de Rede, que usa a fonte de mídia ASF.
Durante o processo de criação do objeto, o resolvedor de origem pesquisa a lista de manipuladores de esquema e os manipuladores de fluxo de bytes no registro do sistema e carrega o manipulador correspondente mais próximo que pode analisar o conteúdo da mídia e também criar o objeto de origem de mídia abaixo. Independentemente do método usado para criar a fonte de mídia (URL e fluxo de bytes), o resolvedor de origem cria um fluxo de bytes e lê o conteúdo da mídia de origem no fluxo de bytes. Para obter mais informações, consulte Manipuladores de esquema e manipuladores de Byte-Stream.
Para obter um exemplo de código sobre como criar uma fonte de mídia, consulte Usando o Resolvedor de Origem.
Configurações para a fonte de mídia ASF
O resolvedor de origem consulta os recursos do fluxo de bytes subjacente e determina que as operações são permitidas na fonte de mídia recém-criada. Uma dessas funcionalidades é buscar. Se uma operação de busca for permitida, o aplicativo poderá especificar o modo de busca que a fonte de mídia usa ao procurar um ponto específico na apresentação.
Um aplicativo pode definir o modo de busca, para a fonte de mídia a ser usada, durante a criação do objeto. Depois que a fonte de mídia ASF for criada com o modo de busca especificado, ela não poderá ser modificada na fonte de mídia ou alterada dinamicamente durante uma apresentação. As preferências de busca são especificadas como propriedades na chamada do aplicativo para os métodos de resolvedor de origem relevantes que são usados para criar a fonte de mídia. Esses conjuntos de propriedades são definidos em um repositório de propriedades e passados para o parâmetro pProps . Se essas propriedades não forem passadas, a fonte de mídia funcionará com as configurações padrão. Para obter mais informações sobre como definir essas propriedades, consulte Configurando uma fonte de mídia.
Se a busca for permitida, a fonte de mídia do ASF oferecerá suporte aos seguintes modos de busca:
- Busca exata: nesse modo, a fonte de mídia DO ASF depende do objeto de índice ASF do arquivo ASF. Se o arquivo não tiver o Objeto Index, a busca exata será desabilitada e um dos outros modos será usado dependendo das propriedades especificadas pelo aplicativo definidas na fonte de mídia.
- Busca aproximada: esse modo é solicitado pelo aplicativo passando MFPKEY_ASFMediaSource_ApproxSeek no repositório de propriedades para os métodos de resolvedor de origem relevantes. No entanto, a busca aproximada só será usada se o fluxo de bytes não oferecer suporte à busca baseada em tempo. Nesse modo, a fonte de mídia determina uma hora de início relativamente mais próxima do tempo de busca. Se o arquivo ASF contiver um Objeto de Índice ASF, ele será usado para calcular a hora de início. A busca aproximada é menos precisa, mas mais rápida do que a busca exata porque o tempo gasto renderiza a primeira amostra na hora de início predeterminada é mais rápido.
- Busca iterativa: para definir esse modo, o aplicativo deve definir a propriedade MFPKEY_ASFMediaSource_IterativeSeekIfNoIndex . A busca iterativa é um algoritmo para encontrar uma posição em um arquivo ASF que não contém nenhum objeto de índice ASF. Nesse modo, a fonte de mídia determina uma estimativa aproximada do ponto de busca lendo o deslocamento do fluxo de bytes. Ele usa uma série de aproximações, com base na taxa média de bits, para se aproximar progressivamente do tempo de busca de destino. (O algoritmo é semelhante a uma pesquisa binária.) A busca iterativa pode levar mais tempo do que procurar usando o Objeto Index, portanto, ela é desabilitada por padrão. Se você definir essa propriedade, use as seguintes propriedades para definir os parâmetros de pesquisa: MFPKEY_ASFMediaSource_IterativeSeek_Max_CountMFPKEY_ASFMediaSource_IterativeSeek_Tolerance_In_MilliSecond. Essas propriedades definem o número máximo de iterações e a tolerância, respectivamente. O algoritmo é interrompido quando atinge o número máximo de iterações ou quando encontra um pacote cuja distância do tempo de busca está dentro da tolerância especificada.
Em poucas palavras, o aplicativo tem a opção de escolher a busca aproximada ou iterativa quando o arquivo ASF não contém um objeto de índice ASF.
Modelo de objeto de origem de mídia ASF
A fonte de mídia ASF implementa a interface IMFMediaSource e expõe as interfaces a seguir. Um aplicativo pode obter uma referência a essas interfaces chamando IMFMediaSource::QueryInterface na fonte de mídia do ASF.
| Interface | Descrição |
|---|---|
| IMFMediaSource | Necessário para todas as fontes de mídia. |
| IMFMediaEventGenerator | Necessário para todas as fontes de mídia. Permite que os aplicativos obtenham eventos da fonte de mídia por meio da Sessão de Mídia. |
| IMFGetService | Consulta a fonte de mídia para a interface de serviço especificada. |
| Ipropertystore | Define e obtém propriedades na fonte de mídia. Cada propriedade contém um nome descritivo e um valor. |
| IMFMetadata | Descreve os metadados do arquivo ASF. |
| IMFMetadataProvider | Recupera uma coleção de metadados, seja para uma apresentação inteira ou para um fluxo na apresentação. |
| IMFRateSupport | Consulta o intervalo de taxas de reprodução com suporte, incluindo a reprodução inversa. |
| IMFRateControl | Obtém ou define a taxa de reprodução. |
| IMFTrustedInput | Obtém o ITA para cada um dos fluxos ASF contidos na origem. |
| IMFPMPClient | Permite que uma fonte de mídia receba um ponteiro para a interface IMFPMPHost , que é usada para criar objetos no processo PMP. |
| IMFTimecodeTranslate | Converte entre códigos de tempo da Society of Motion Picture and Television Engineers (SMPTE) e unidades de tempo de 100 nanossegundos. |
Serviços de Origem de Mídia do ASF
A fonte de mídia ASF fornece vários serviços com escopo para o arquivo ASF. Para obter um ponteiro para um determinado serviço, o aplicativo deve usar um dos seguintes identificadores de serviço em sua chamada para MFGetService. Para obter informações, consulte Interfaces de serviço.
| Identificador de Serviço | Descrição |
|---|---|
| MF_RATE_CONTROL_SERVICE | Usando esse identificador, um aplicativo pode obter um ponteiro para interfaces IMFRateSupport ou IMFRateControl . Usando o objeto de suporte de taxa implementado pela fonte de mídia, o aplicativo pode marcar se uma taxa específica for compatível com o arquivo de mídia ASF subjacente também obter a taxa mais rápida e mais lenta. Usando o objeto de controle de taxa, o aplicativo pode obter e definir a taxa de reprodução. Se o aplicativo especificar uma taxa específica para reprodução, a fonte de mídia ASF primeiro verificará se a taxa solicitada está dentro dos limites de taxa (determinada por taxas mais rápidas e lentas) e, em seguida, define a taxa. Isso não marcar para condições variáveis, pois a taxa de bits pode mudar a qualquer momento, dependendo da largura de banda da rede. Para obter mais informações, Controle de taxa. |
| MF_METADATA_PROVIDER_SERVICE | Usando esse identificador, o aplicativo pode obter um ponteiro para a interface IMFMetadataProvider da fonte de mídia ASF. Essa interface fornece acesso a informações sobre o arquivo ASF especificamente os Objetos de Cabeçalho ASF e os fluxos contidos no conteúdo da mídia. As informações de cabeçalho são expostas por meio de atributos do descritor de apresentação e as informações de fluxo são fornecidas por meio de atributos de descritor de fluxo. Para obter mais informações sobre esses atributos, consulte Atributos do Media Foundation para objetos de cabeçalho ASF. Além das informações expostas por meio de atributos, também existem metadados descritivos, que são definidos como propriedades. |
| MF_PROPERTY_HANDLER_SERVICE | Usando esse identificador, o aplicativo pode obter um ponteiro para a interface IPropertyStore da fonte de mídia ASF. O repositório de propriedades contém todos os metadados relacionados ao arquivo ASF. Esse identificador é novo no Windows 7 e substitui MF_METADATA_PROVIDER_SERVICE para obter propriedades de metadados. |
| MFNETSOURCE_STATISTICS_SERVICE | Para obter mais informações, consulte Recuperando estatísticas de rede no log do cliente. |
| MF_TIMECODE_SERVICE | Usando esse identificador, o aplicativo pode obter um ponteiro para a interface IMFTimecodeTranslate da fonte de mídia. Essa implementação pode ser usada para executar traduções de código de tempo, como converter o código de tempo SMPTE em unidades de 100 nano segundos e voltar. |
Tradução de código de tempo
A fonte de mídia ASF fornece um serviço de tradução de código de tempo que permite que seu aplicativo converta o código de tempo SMPTE no horário de apresentação mais próximo (na unidade de 100 nanossegundos). Por outro lado, o aplicativo também pode obter o código de tempo para um horário de apresentação solicitado. O serviço está disponível por meio da interface IMFTimecodeTranslate , que a fonte de mídia ASF implementa. As chamadas de método nesse ponteiro de interface são assíncronas que podem ser executadas no thread do aplicativo main sem bloquear a interface do usuário do aplicativo.
As seguintes etapas resumem o procedimento para conversão de código de tempo:
- Obtenha o ponteiro para a interface IMFTimecodeTranslate da fonte de mídia ASF chamando MFGetService e especificando o identificador MF_TIMECODE_SERVICE .
- Chame IMFTimecodeTranslate::BeginConvertTimecodeToHNS ou IMFTimecodeTranslate::BeginConvertHNSToTimecode e especifique a hora a ser convertida.. Para BeginConvertTimecodeToHNS , o código de hora deve ser especificado como uma variável PROPVARIANT com VT_I8 tipo de dados. O método BeginConvertHNSToTimecode requer o tempo em unidades de 100 nanossegundos como o tipo MFTIME .
- Conclua a operação assíncrona chamando IMFTimecodeTranslate::EndConvertTimecodeToHNS ou IMFTimecodeTranslate::EndConvertTimecodeToHNS adequadamente.
Durante a criação da fonte de mídia, o resolvedor de origem cria um fluxo de bytes para o arquivo do qual a fonte de mídia lê o conteúdo ASF. Para que as conversões de tempo sejam bem-sucedidas, o fluxo de bytes associado ao arquivo ASF deve ter recursos de busca; caso contrário, o aplicativo obtém o erro MF_E_BYTESTREAM_NOT_SEEKABLE da chamada Begin... . Outro requisito para conversões de tempo é que o arquivo ASF, representado pela fonte de mídia ASF, deve ter objetos de índice ASF. Os horários de apresentação e os códigos de tempo são extraídos dos Objetos de Índice ASF que mantêm todos os índices e os pontos de busca correspondentes para o arquivo ASF. Para a conversão de código de tempo a tempo da apresentação, o arquivo ASF deve conter um objeto de índice simples; para conversão de tempo de código para apresentação, o arquivo ASF deve ter um Objeto Index. As operações de conversão dependem do indexador subjacente (componente WMContainer) para analisar e ler o Objeto Index associado ao arquivo ASF. Se o arquivo não contiver um Objeto Index, o aplicativo receberá de forma assíncrona o código de erro MF_E_NO_INDEX.
Para traduzir o tempo solicitado pelo aplicativo, a fonte de mídia enumera os fluxos dentro do arquivo e localiza o fluxo que contém o objeto de índice ASF apropriado. Se esse fluxo for encontrado, a fonte de mídia analisará os pacotes ASF do fluxo até que o código de hora correto seja atingido. Depois de encontrar o exemplo correto, ele recupera o tempo de apresentação correspondente ou o código de tempo do exemplo e o retorna ao chamador.
Suporte a comandos de script
Quando você cria uma topologia ASF que contém um fluxo de script, um nó do Fluxo de Script é adicionado à topologia. Este nó enviará IMFSamples no momento apropriado. O IMFSample fornecido pelo nó de origem do script armazena os dados no IMFMediaBuffer associado à amostra. Você pode chamar CopyToBuffer no exemplo para obter um IMFMediaBuffer e, em seguida, chamar Lock no buffer para obter os dados.
As cargas de fluxo de script são empacotadas no buffer como uma cadeia de caracteres de tipo, seguida por NULL, seguida pela cadeia de caracteres de comando, seguida por NULL. As cadeias de caracteres são Unicode no formato ASF.
Por exemplo, uma carga pode ser semelhante à seguinte (em que \0 indica um caractere NULL):
URL\0http://contoso.com\0
Text\0This é um legenda\0
Tópicos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de