Události relace médií
Většina operací relace médií se provádí asynchronně, takže aplikace musí naslouchat událostem pomocí rozhraní MMFMediaEventGenerator media Session. (Rozhraní MMFMediaSession dědí MMFMediaEventGenerator.) Přesná posloupnost událostí bude záviset na vaší aplikaci, ale v téměř jakékoli situaci vyvolá relace médií následující události.
| Událost | Popis |
|---|---|
| MEEndOfPresentation | Vyvolá se, když zdroj médií dokončí prezentaci. Data se v tuto chvíli můžou stále přesouvat přes kanál. |
| MEError | Vyvolá se, pokud během streamování dojde k chybě. |
| MESessionClosed | Vyvolá se při dokončení metody Close. Tato událost je poslední událost, kterou fronty relace médií. Po přijetí této události je bezpečné vypnout všechny zdroje médií, které jste vytvořili. |
| MESessionEnded | Vyvolá se při dokončení relace multimédií s poslední prezentací. |
| MESessionNotifyPresentationTime | Upozorní aplikaci času prezentace, když se nová prezentace spustí. |
| MESessionStarted | Vyvolá se při dokončení metody Start. Pokud nedošlo k chybě, data v tomto okamžiku procházejí kanálem. |
| MESessionTopologySet | Vyvolá se při dokončení metody SetTopology. Pokud nedojde k chybě, aplikace nemusí provádět žádnou akci. |
| MESessionTopologyStatus | Vyvolána v různých časech, když se změní stav topologie. |
Metoda MMFMediaSession::Shutdown nevyvolá událost. Metoda Shutdown je synchronní. Po vrácení této metody je bezpečné uvolnit ukazatel zpětného volání události.
Kromě událostí z relace médií může aplikace přijímat události z jímek médií v topologii. Můžou to být vlastní události definované jímkou médií, které můžou obsahovat libovolná data. Jímka může například odvodit data události ze zdrojových dat, která mohou být z nedůvěryhodného externího zdroje. Aplikace by měla ignorovat všechny události, které nerozpozná, a při analýze dat událostí byste měli postupovat opatrně.
Související témata