Eventos da Sessão de Imprensa
A maioria das operações da Media Session é executada de forma assíncrona, portanto, o aplicativo deve ouvir eventos usando a interfaceIMFMediaEventGenerator da Media Session. (A interface IMFMediaSession herda IMFMediaEventGenerator.) A sequência exata de eventos dependerá do seu aplicativo, mas os eventos a seguir são gerados pela Sessão de Mídia em quase todas as situações.
| Evento | Descrição |
|---|---|
| MEEndOfPresentation | Gerado quando a fonte de mídia tiver concluído a apresentação. Os dados ainda podem estar se movendo através do pipeline no momento. |
| MEError | Gerado se ocorrer um erro durante o streaming. |
| MESessionClosed | Gerado quando o método Close é concluído. Este evento é o último evento que a Sessão de Mídia enfileira. Depois de receber esse evento, é seguro desligar todas as fontes de mídia que você criou. |
| MESessionEnded | Levantado quando a Sessão de Mídia é feita com a última apresentação. |
| MESessionNotifyPresentationTime | Notifica o aplicativo do tempo de apresentação quando a nova apresentação será iniciada. |
| MESessionStarted | Gerado quando o método Start é concluído. A menos que ocorra um erro, os dados estão se movendo pelo pipeline neste momento. |
| MESessionTopologySet | Gerado quando o método SetTopology é concluído. A menos que ocorra um erro, o aplicativo não precisa executar nenhuma ação. |
| MESessionTopologyStatus | Gerado em vários momentos quando o status de uma topologia muda. |
O método IMFMediaSession::Shutdown não gera um evento. O método Shutdown é síncrono. Depois que esse método retornar, é seguro liberar o ponteiro de retorno de chamada do evento.
Além dos eventos da Sessão de Mídia, o aplicativo pode receber eventos dos coletores de mídia na topologia. Esses podem ser eventos personalizados definidos pelo coletor de mídia, que podem conter dados arbitrários. Por exemplo, o coletor pode derivar os dados do evento dos dados de origem, que podem ser de uma fonte externa não confiável. Um aplicativo deve ignorar quaisquer eventos que não reconheça e ter cuidado ao analisar dados de eventos.
Tópicos relacionados