otc_subscriber_callbacks
Fonctions de rappel des abonnés.
Cette structure regroupe des pointeurs vers des fonctions pouvant être appelées lors d'événements liés à un abonné OpenTok.
Tous les rappels ne seront pas effectués sur l'application ou le thread principal, mais sur un thread interne. L'application doit renvoyer le rappel le plus rapidement possible afin d'éviter de bloquer le thread interne.
Propriétés
| Nom | Type | Description |
|---|---|---|
user_data |
void * | Cet élément de la structure peut pointer vers des données relatives à l'abonné dont le développeur pourrait avoir besoin. |
reserved |
void * | Un pointeur nul vers une zone de mémoire contenant des ressources réservées utilisées pour la mise en œuvre interne. |
Rappels
| Nom | Description |
|---|---|
on_connected(subscriber, user_data, stream) |
Appelée lorsque l'instance s'est connectée avec succès au flux et commence la lecture du contenu multimédia. |
on_disconnected(subscriber, user_data) |
Appelée lorsque le flux de l'abonné a été interrompu. |
on_reconnected(subscriber, user_data) |
Appelée lorsque le flux de l'abonné a repris. |
on_render_frame(subscriber, user_data, frame) |
Appelée lorsqu'une nouvelle image vidéo destinée à l'abonné est prête à être affichée. |
on_video_disabled(subscriber, user_data, reason) |
Appelée lorsque la vidéo de l'abonné est désactivée. |
on_video_enabled(subscriber, user_data, reason) |
Appelée lorsque la vidéo de l'abonné est activée. |
on_audio_disabled(subscriber, user_data) |
Appelée lorsque le son de l'abonné est désactivé. |
on_audio_enabled(subscriber, user_data) |
Appelée lorsque le son de l'abonné est activé. |
on_video_data_received(subscriber, user_data) |
Appelée lorsqu'un abonné reçoit des données vidéo pour la première fois. |
on_video_disable_warning(subscriber, user_data) |
Cette méthode est appelée lorsque le routeur multimédia OpenTok détecte une dégradation de la qualité du flux et que la vidéo sera désactivée si cette dégradation se poursuit. |
on_caption_text(subscriber, user_data, text, is_final) |
Appelée lorsque le texte des sous-titres du flux de l'abonné est disponible. |
on_video_disable_warning_lifted(subscriber, user_data) |
Appelée lorsque le routeur multimédia OpenTok constate que la qualité du flux s'est suffisamment améliorée pour que la désactivation de la vidéo ne présente plus de risque immédiat. |
on_audio_stats(subscriber, user_data, audio_stats) |
Appelée périodiquement pour transmettre les statistiques audio relatives à l'abonné. |
on_video_stats(subscriber, user_data, video_stats) |
Appelée périodiquement pour transmettre les statistiques vidéo relatives à l'abonné. |
on_audio_level_updated(subscriber, user_data, audio_level) |
Appelée périodiquement pour communiquer le niveau audio de l'abonné. |
on_error(subscriber, user_data, error_string, error) |
Appelée en cas d'échec de l'abonné. |
on_audio_data(subscriber, user_data, audio_data) |
Appelée périodiquement pour transmettre les données audio de l'abonné. |
on_network_condition_changed(subscriber, user_data, media_link_stats, reason) |
Cette fonction de rappel est appelée lorsqu'un événement lié à la qualité est détecté du côté de l'abonné. |
on_media_link_stats(subscriber, user_data, media_link_stats) |
Appelée périodiquement pour communiquer les statistiques relatives aux liens multimédias de l'abonné. |
on_connected(abonné, données_utilisateur, flux)
Appelée lorsque l'instance s'est connectée avec succès au flux et commence la lecture du contenu multimédia.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
stream |
const otc_stream * | Le flux de l'abonné. L'instance ne survit pas à l'exécution de la fonction de rappel. Veillez à en faire une copie si vous comptez réutiliser cette instance ultérieurement. |
on_disconnected(abonné, données_utilisateur)
Appelée lorsque le flux de l'abonné a été interrompu. Cette fonction de rappel n'est invoquée que si la fonctionnalité de reconnexion est activée ; elle est suivie de la fonction on_reconnected si la reconnexion aboutit. Les interruptions habituelles, lorsque la reconnexion n'est pas activée, sont signalées via la fonction de rappel on_error.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_reconnected(abonné, données_utilisateur)
Appelée lorsque le flux de l'abonné a repris.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_render_frame(abonné, données_utilisateur, image)
Appelée lorsqu'une nouvelle image vidéo destinée à l'abonné est prête à être affichée. Ne pas appeler n'importe quelle fonction de l'API OpenTok (à l'exception de celles figurant dans video_frame.h) dans le même thread que celui qui déclenche ce callback. Si vous devez appeler une fonction de l'API OpenTok (par exemple, des fonctions dans publisher.h ou subscriber.h), reporter son exécution sur un autre thread.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
frame |
const otc_video_frame * | L'image vidéo. |
on_video_disabled(abonné, données_utilisateur, motif)
Appelée lorsque la vidéo de l'abonné est désactivée.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
reason |
énumération otc_video_reason | Fournit plus de détails sur les raisons pour lesquelles la vidéo a été désactivée. |
on_video_enabled(abonné, données_utilisateur, motif)
Appelée lorsque la vidéo de l'abonné est activée.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
reason |
énumération otc_video_reason | Fournit plus de détails sur les raisons pour lesquelles la vidéo a été activée. |
on_audio_disabled(abonné, données_utilisateur)
Appelée lorsque le son de l'abonné est désactivé.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_audio_enabled(abonné, données_utilisateur)
Appelée lorsque le son de l'abonné est activé.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_video_data_received(abonné, données_utilisateur)
Appelée lorsqu'un abonné reçoit des données vidéo pour la première fois.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_video_disable_warning(abonné, données_utilisateur)
Cette méthode est appelée lorsque le routeur multimédia OpenTok détecte une dégradation de la qualité du flux et que la vidéo sera désactivée si cette dégradation se poursuit.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_caption_text(abonné, données_utilisateur, texte, est_final)
Appelée lorsque le texte des sous-titres du flux de l'abonné est disponible.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance de l'abonné. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
text |
const char * | Pointeur vers le texte de la légende. |
is_final |
otc_bool | Indique si un sous-titre est terminé. |
on_video_disable_warning_lifted(abonné, données_utilisateur)
Appelée lorsque le routeur multimédia OpenTok constate que la qualité du flux s'est suffisamment améliorée pour que la désactivation de la vidéo ne présente plus de risque immédiat.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
on_audio_stats(abonné, données_utilisateur, statistiques_audio)
Appelée périodiquement pour transmettre les statistiques audio relatives à l'abonné.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
audio_stats |
struct otc_subscriber_audio_stats | Un pointeur vers la structure « stats » audio. |
on_video_stats(abonné, données_utilisateur, statistiques_vidéo)
Appelée périodiquement pour transmettre les statistiques vidéo relatives à l'abonné.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
video_stats |
struct otc_subscriber_video_stats | Un pointeur vers la structure contenant les statistiques de la vidéo. |
on_audio_level_updated(abonné, données_utilisateur, niveau_audio)
Appelée périodiquement pour communiquer le niveau audio de l'abonné.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
audio_level |
flotter | La valeur du niveau audio, comprise entre 0 et 1,0. |
on_error(abonné, données_utilisateur, chaîne_d'erreur, erreur)
Appelée en cas d'échec de l'abonné.
La plupart des erreurs sont fatales : l'abonné est automatiquement déconnecté et ne peut plus être utilisé. Certaines erreurs ne sont pas fatales et permettent de continuer à utiliser l'abonné ; lorsqu'une erreur n'est pas fatale, cela est précisé dans la description de l'erreur.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
error_string |
const char * | Une chaîne de caractères contenant le message d'erreur. |
error |
énumération otc_subscriber_error_code | Valeur de l'énumération des codes d'erreur. |
on_audio_data(abonné, données_utilisateur, données_audio)
Appelée périodiquement pour transmettre les données audio de l'abonné. Les propriétés audio reçues peuvent évoluer de manière dynamique. Ces changements peuvent être dus à la négociation du codec audio, aux conditions du réseau, etc. Il incombe aux consommateurs des données audio de gérer ces changements en fonction du cas d'utilisation mis en œuvre (par exemple, le rééchantillonnage audio).
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
audio_data |
const struct otc_audio_data * | Les données audio. |
on_network_condition_changed(abonné, données_utilisateur, statistiques_liaison_multimédia, motif)
Cette fonction de rappel est appelée lorsqu'un événement lié à la qualité est détecté du côté de l'abonné.
Dans l'implémentation actuelle, cet événement n'est déclenché qu'en cas d'interruption de la vidéo (pause), de changement de codec ou de changement de résolution. Les blocages sont suivis en interne et mis en évidence via les statistiques, mais aucun rappel n'est déclenché pour chaque blocage en raison de leur courte durée et de leur fréquence potentiellement élevée. Un rappel n'est déclenché que lorsqu'une pause est détectée (par exemple, aucune image affichée pendant plus de 5 secondes), car cela représente une perturbation plus importante de la lecture multimédia.
Les reason Ce paramètre indique la cause de l'événement et est pris en compte selon l'ordre de priorité suivant : OTC_VIDEO_REASON_VIDEO_INTERRUPT, OTC_VIDEO_REASON_CODEC_CHANGE, OTC_VIDEO_REASON_RESOLUTION_CHANGE.
Cet événement diffère de on_video_disabled et on_video_enabled des « callbacks » dans la mesure où il signale les changements ayant une incidence sur la qualité vidéo. on_video_disabled et `on_video_enabled` indiquent uniquement que la piste vidéo de l'abonné a été activée ou désactivée (par exemple, à la suite d'une mise à jour des propriétés du flux ou d'un basculement vers l'audio). En revanche, cet événement fournit des informations de diagnostic sur les causes de dégradation de la qualité, telles que les blocages, le nombre de pauses et les statistiques mises à jour.
Cette fonction de rappel prend en compte tous les types d'interruptions vidéo d'une durée de 5 secondes ou plus. Cela signifie que, dans le cas particulier d'un basculement vers l'audio ou de modifications des propriétés du flux (comme la désactivation de la vidéo), outre le déclenchement de la on_video_disabled et on_video_enabled Dans le cas des rappels, l'interruption est également enregistrée comme une pause dans les statistiques vidéo, et une qualité d'interruption vidéo correspondante
Les applications peuvent utiliser ce callback pour gérer les problèmes de qualité, par exemple pour mettre à jour l'interface utilisateur, enregistrer des données de télémétrie ou avertir l'utilisateur.
/** Cette fonction de rappel est appelée lorsqu'un changement d'état réseau est détecté pour l'abonné ou l'éditeur distant.
Dans l'implémentation actuelle, cette fonction de rappel n'est déclenchée que lorsque l'état du réseau a changé pour l'un ou l'autre des deux côtés.
Les reason Ce paramètre indique la cause de l'événement et prend actuellement toujours la valeur OTC_NETWORK_REASON_NETWORK_CONDITION_CHANGE.
Cet événement diffère de on_video_disabled et on_video_enabled Ces callbacks se distinguent en ce qu'ils signalent les changements d'état du réseau plutôt que ceux de la piste vidéo de l'abonné. Les applications peuvent utiliser ce callback pour réagir à des problèmes réseau, par exemple en mettant à jour l'interface utilisateur, en enregistrant des données de télémétrie ou en déclenchant un comportement adaptatif.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance d'abonné à l'origine de l'événement. |
user_data |
void * | Pointeur de données utilisateur facultatif transmis lors de l'enregistrement de la fonction de rappel. |
media_link_stats |
const struct otc_subscriber_media_link_stats * | Statistiques relatives aux liens vers les médias. |
reason |
énumération otc_network_reason | La raison du changement d'état du réseau. |
on_media_link_stats(abonné, données_utilisateur, statistiques_lien_média)
Appelée périodiquement pour communiquer les statistiques relatives aux liens multimédias de l'abonné.
Les statistiques relatives aux liaisons de support offrent une vue d'ensemble des conditions du réseau au niveau du transport.
Paramètres :
| Nom | Type | Description |
|---|---|---|
subscriber |
otc_subscriber * | L'instance qui effectue cet appel. |
user_data |
void * | Pointeur vers les données personnalisées de l'utilisateur associées à cette structure. |
media_link_stats |
const struct otc_subscriber_media_link_stats * | Un pointeur vers la structure « stats » du lien multimédia. |