Fonctions de base. En savoir plus...
#include "config.h"
| Structures de données | |
| struct | otc_on_mute_forced_info |
| struct | otc_transport_stats |
| Définitions de types | |
| typedef int | otc_bool |
| typedef int | otc_status |
| typedef void(* | otc_logger_callback) (const char *message) |
| Fonctions | |
| otc_status | otc_init (void *réservé) |
| otc_status | otc_destroy () |
| void | otc_log_set_logger_callback (otc_logger_callback (rappel) |
| void | otc_log_enable (énumération otc_log_level log_level) |
| énumération otc_log_level | otc_get_log_level () |
Description détaillée
Fonctions de base.
Ce fichier contient des fonctions permettant d'initialiser et de détruire le moteur de la bibliothèque, ainsi que d'autres fonctions permettant d'activer la journalisation sur la console.
Documentation sur `typedef`
otc_bool
| typedef int otc_bool |
Définition de type pour les valeurs booléennes.
Type utile pour les variables représentant des valeurs booléennes (vrai et faux).
otc_logger_callback
| typedef void(* otc_logger_callback) (const char *message) |
Définition de type pour un pointeur vers la fonction utilisée comme callback de journalisation personnalisée permettant d'enregistrer les messages générés par le SDK.
Paramètres : | | | | --- | --- | | message | Un pointeur vers le message en cours d'enregistrement. |
Voir aussi : otc_log_set_logger_callback
otc_status
| typedef int otc_status |
Définition de type pour les statuts.
Il s'agit du type de valeur de retour le plus courant pour les fonctions de cette bibliothèque. Ce type inclut les valeurs issues des énumérations de codes d'erreur.
Voir aussi : otc_constant : otc_code_erreur : otc_session_error_code : otc_publisher_error_code : otc_code_erreur_abonné
Documentation sur les types d'énumération
otc_constant
| énumération otc_constant |
Cette liste comprend les constantes couramment utilisées.
| Recenseur | |
|---|---|
| OTC_SUCCESS | Constante qui symbolise la réussite. |
| OTC_FALSE | Constante représentant la valeur « faux ». |
| OTC_TRUE | Constante représentant la valeur « vrai ». |
otc_code_erreur
| énumération otc_code_erreur |
Cette liste comprend les codes d'erreur.
| Recenseur | |
|---|---|
| OTC_INVALID_PARAM | Code d'erreur : argument de fonction non valide. Un argument utilisé dans un appel de fonction n'est pas valide. |
| OTC_FATAL | Code d'erreur fatale. Erreur générique. |
| OTC_INVALID_VIDEO_FORMAT | Format vidéo non valide Généré lorsque le dispositif de capture est configuré avec un format vidéo non valide |
| OTC_CONNECTION_DROPPED | Code d'erreur « Connexion interrompue ». La connexion au serveur de messagerie OpenTok a été interrompue. Vérifiez votre connexion réseau. |
| OTC_UNABLE_TO_FORCE_DISCONNECT | Code d'erreur de déconnexion forcée. Impossible d'effectuer l'appel otc_session_force_disconnect, peut-être en raison d'autorisations manquantes. |
| OTC_UNABLE_TO_FORCE_MUTE | Code d'erreur « Force mute ». Impossible d'effectuer l'appel otc_session_force_mute_all ou otc_session_force_mute_stream, peut-être en raison d'autorisations manquantes. |
| OTC_CONNECTION_TIMED_OUT | Code d'erreur de délai d'attente de connexion. Délai d'attente dépassé lors d'une tentative de connexion. |
| OTC_UNKNOWN_PUBLISHER_INSTANCE | Code d'erreur d'instance Publisher inconnu. Une instance Publisher inconnue a été utilisée comme argument de fonction. |
| OTC_UNKNOWN_SUBSCRIBER_INSTANCE | Code d'erreur d'instance d'abonné inconnue. Une instance d'abonné inconnue a été utilisée comme argument de fonction. |
| OTC_VIDEO_CAPTURE_FAILED | Code d'erreur de capture vidéo. Une erreur s'est produite au niveau de la carte de capture vidéo. |
| OTC_CAMERA_FAILED | Code d'erreur lors de l'acquisition de la vidéo de la caméra. Une erreur s'est produite lors de l'acquisition de la vidéo de la caméra. |
| OTC_VIDEO_RENDER_FAILED | Code d'erreur de rendu vidéo. Une erreur s'est produite lors du rendu de la vidéo. |
| OT_UNABLE_TO_ACCESS_MEDIA_ENGINE | Code d'erreur d'accès au moteur multimédia. Une erreur s'est produite lors de la tentative de récupération de la liste des codecs vidéo pris en charge. |
otc_log_level
| énumération otc_log_level |
Énumération des niveaux de journalisation.
Cette liste répertorie les différents niveaux de journalisation pris en charge.
| Recenseur | |
|---|---|
| OTC_LOG_LEVEL_DISABLED | Valeur d'énumération « Aucun message ». |
| OTC_LOG_LEVEL_ERROR | Messages indiquant le niveau d'erreur. |
| OTC_LOG_LEVEL_WARN | Messages de niveau d'alerte. |
| OTC_LOG_LEVEL_INFO | Messages de niveau « Info ». |
| OTC_LOG_LEVEL_DEBUG | Messages de niveau débogage. |
| OTC_LOG_LEVEL_TRACE | Messages de niveau « trace » (les plus détaillés). |
| OTC_LOG_LEVEL_FATAL | OBSOLÈTE. |
| OTC_LOG_LEVEL_MSG | OBSOLÈTE. |
| OTC_LOG_LEVEL_ALL | OBSOLÈTE. |
otc_état_du_réseau
| énumération otc_état_du_réseau |
Note estimée de l'état du réseau pour un transport.
Cette énumération représente l'état général de la connexion réseau pour un transport donné (local ou distant). Elle est généralement calculée à partir d'indicateurs tels que la perte de paquets et la bande passante disponible estimée. Plus les valeurs sont élevées, meilleures sont les conditions réseau.
Les codes OTC_NETWORK_CONDITION_WARNING et OTC_NETWORK_CONDITION_CRITICAL indiquent une dégradation des conditions réseau susceptible de déclencher des callbacks de basculement audio. Si le basculement audio est activé, le SDK enverra une notification via les callbacks correspondants ; dans l'état CRITICAL, la vidéo est désactivée afin de préserver la stabilité de l'appel.
| Recenseur | |
|---|---|
| OTC_NETWORK_CONDITION_UNKNOWN | Impossible de déterminer l'état du réseau |
| OTC_NETWORK_CONDITION_CRITICAL | Problèmes réseau graves ; la solution de secours audio est activée si elle est configurée |
| OTC_NETWORK_CONDITION_WARNING | Conditions réseau médiocres ; la qualité vidéo en est fortement affectée et un avertissement de désactivation de la vidéo peut s'afficher si le repli audio est activé |
| OTC_NETWORK_CONDITION_FAIR | Conditions réseau moyennes ; la qualité vidéo peut être limitée par le serveur multimédia ou par un autre utilisateur |
| OTC_NETWORK_CONDITION_GOOD | Les conditions de connexion sont bonnes ; des problèmes mineurs et temporaires peuvent survenir. |
| OTC_NETWORK_CONDITION_EXCELLENT | Les conditions réseau sont excellentes ; la qualité vidéo est optimale et la bande passante estimée permet de prendre en charge le débit binaire maximal pour la résolution actuelle. |
otc_network_degradation_source
| énumération otc_network_degradation_source |
Indique la source de la dégradation de la qualité vidéo ou du réseau au cours de la session.
Cette énumération permet d'identifier quelle partie de l'appel est à l'origine des problèmes réseau constatés qui affectent la qualité vidéo. Elle vient compléter les indicateurs d'état du réseau par mode de transport.
| Recenseur | |
|---|---|
| OTC_NETWORK_DEGRADATION_SOURCE_NONE | Aucune dégradation n'a été détectée ; la qualité vidéo est bonne. |
| OTC_NETWORK_DEGRADATION_SOURCE_BOTH_OR_UNCLEAR | Une dégradation a été détectée, mais il est impossible d'en déterminer la cause. |
| OTC_NETWORK_DEGRADATION_SOURCE_LOCAL | Le réseau local ou le réseau de transport est à l'origine de la dégradation. |
| OTC_NETWORK_DEGRADATION_SOURCE_REMOTE | Le réseau ou le transport à distance est à l'origine de la dégradation. |
otc_network_reason
| énumération otc_network_reason |
Énumération décrivant les causes ayant une incidence sur l'état du réseau.
Ces valeurs indiquent le principal facteur influant sur l'évaluation de l'état actuel du réseau, tel que les contraintes de bande passante ou la perte de paquets.
| Recenseur | |
|---|---|
| OTC_NETWORK_REASON_NONE | Aucune raison particulière. |
| OTC_NETWORK_REASON_UNKNOWN | Raison inconnue. |
| OTC_NETWORK_REASON_BANDWIDTH | La note d'état du réseau dépend de la bande passante. |
| OTC_NETWORK_REASON_PACKET_LOSS | L'indice d'état du réseau est influencé par la perte de paquets. |
| OTC_NETWORK_REASON_NETWORK_CONDITION_CHANGE | Indique que l'état du réseau d'un participant local ou distant a changé. Ce message est déclenché lorsqu'un changement significatif est détecté sur le réseau d'un participant local ou distant. |
otc_video_reason
| énumération otc_video_reason |
Énumération des motifs pouvant entraîner le démarrage, l'arrêt, la reprise, etc. d'une vidéo.
| Recenseur | |
|---|---|
| OTC_VIDEO_REASON_NONE | Aucune dégradation de la qualité ni événement vidéo notable. Raison par défaut ou inconnue. |
| OTC_VIDEO_REASON_PUBLISH_VIDEO | Le client qui diffusait le flux a cessé de diffuser la vidéo. |
| OTC_VIDEO_REASON_SUBSCRIBE_TO_VIDEO | Le client local a résilié son abonnement à la vidéo. |
| OTC_VIDEO_REASON_QUALITY | Ce problème vidéo a été provoqué par une modification de la qualité du flux vidéo. |
| OTC_VIDEO_REASON_CODEC_NOT_SUPPORTED | Ce problème vidéo s'est produit lorsque la vidéo du flux de l'abonné a été désactivée, car ce flux utilise un codec vidéo non pris en charge par l'appareil. |
| OTC_VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH | Dégradation de la qualité due à une bande passante réseau insuffisante. |
| OTC_VIDEO_REASON_QUALITY_DEGRADATION_CPU | Dégradation de la qualité due aux limitations du processeur de l'appareil client. |
| OTC_VIDEO_REASON_QUALITY_DEGRADATION_OTHER | Dégradation de la qualité due à d'autres causes |
| OTC_VIDEO_REASON_CODEC_CHANGE | Le codec vidéo a changé |
| OTC_VIDEO_REASON_RESOLUTION_CHANGE | Modification de la résolution vidéo ou du nombre de couches. Ce phénomène peut être dû à des contraintes de débit binaire, à l'adaptation de l'encodeur, à des changements au niveau de la source de la caméra (par exemple, changement de caméra ou modification de la résolution d'entrée) ou à des modifications de configuration, et n'implique pas nécessairement une dégradation de la qualité. |
| OTC_VIDEO_REASON_VIDEO_INTERRUPTION | Événement d'interruption vidéo |
| OTC_VIDEO_REASON_SENDER_QUALITY_RESTRICTION | Qualité vidéo limitée par l'expéditeur |
Documentation des fonctions
otc_destroy()
| otc_status otc_destroy | ( | ) |
Détruit le moteur de la bibliothèque. Vous devez appeler cette fonction lorsque vous avez fini d'exécuter le code qui utilise la bibliothèque.
Valeurs de retour : Valeur de retour indiquant soit une erreur, soit une réussite.
otc_get_log_level()
| énumération otc_log_level otc_get_log_level | ( | ) |
Récupère le niveau de journalisation actuel de la console.
Valeurs renvoyées : Le niveau de journalisation défini.
otc_init()
| otc_status otc_init | ( | void * | réservé | ) |
Initialise la bibliothèque. Vous devez appeler cette fonction avant l'exécution de tout autre code utilisant la bibliothèque.
Paramètres
: | | |
| --- | --- |
| réservé | Pointeur de type void vers une zone de mémoire contenant des ressources réservées utilisées pour la mise en œuvre interne. Cette valeur doit être définie sur NULL. |
Valeurs de retour : Valeur de retour indiquant soit une erreur, soit une réussite.
otc_log_enable()
| void otc_log_enable | ( | énumération otc_log_level | niveau_journal | ) |
Active la journalisation des messages du SDK pour un niveau de journalisation donné.
Paramètres : | | | | --- | --- | | log_level | Le niveau de journalisation souhaité. |
Voir aussi : otc_log_set_logger_callback : otc_get_log_level
otc_log_set_logger_callback()
| void otc_log_set_logger_callback | ( | otc_logger_callback | rappel | ) |
Définit le pointeur de fonction vers une fonction de rappel de journalisation personnalisée afin de récupérer les messages consignés par le SDK. Si vous ne définissez pas de fonction de rappel de journalisation, le SDK consignera les messages dans la console.
Paramètres : | | | | --- | --- | | callback | Un pointeur vers la fonction de rappel. |
Voir aussi : otc_log_enable