Aller au contenu
Documentation

Limites RTC et dépannage

La fonctionnalité RTC doit être activée sur l’abonnement actif. Les pages « Contrôle des forfaits » et Utilisation La page « Utilisation » affiche les quotas applicables à l’espace de travail. Ne partez pas du principe que tous les abonnements portant le même nom commercial ont des limites identiques. Forfaits et facturation répertorie l’essai, les niveaux et les packs, et GET /v1/subscription (session de console connectée) restitue toutes les allocations.

Code de fonctionnalitéCommandes
max-projectsQuota de création de projets
max-participantsCapacité maximale de participants autorisée par salle
participant-minutesQuota de temps par participant
recording-jobsQuota de tâches d’enregistrement

Une clé de serveur utilise les droits d’accès et les autorisations de l’espace de travail auquel elle appartient, et non un abonnement distinct pour la personne détentrice de la clé. L’augmentation de la capacité demandée pour une salle ne peut pas outrepasser le forfait ou la capacité multimédia disponible.

Les totaux d’activité indiquent l’historique des connexions terminées. Il ne s’agit ni d’une occupation en temps réel ni d’une facture relative à une période de facturation. Les mises à jour concernant l’utilisation et la facturation sont asynchrones. Consultez la section centrale Facturation concernant les détails de l’abonnement et les factures.

  • La capacité de la salle est un nombre entier d’au moins deux, dans la limite du nombre de participants autorisé dans l’espace de travail de l’hôte. La capacité multimédia disponible est vérifiée indépendamment du forfait. Un refus temporaire de capacité ne signifie pas qu’une mise à niveau du forfait est nécessaire.
  • Les listes sont paginées avec ?limit et ?cursor (voir le API conventions) et ne disposent pas de recherche côté serveur. La recherche dans la console porte uniquement sur la liste chargée.
  • Les requêtes sont limitation de débit par adresse IP, API clé et organisation.
  • Le changement de nom, la réouverture et la suppression d’une salle ne sont actuellement pas des méthodes prises en charge par les clients.
  • Les clés d’idempotence des mutations générales et les API d’exportation en masse ne sont pas disponibles.
  • Utilisez la distributionSDK Web prise en charge. Les guides spécifiques aux serveurs Python/Node.js etSDKs aux piles seront bientôt disponibles ; il ne s’agit pas de versions installables.
  • Les enregistrements contiennent des pistes individuelles, et non une vidéo montée. Voir Contraintes d’enregistrement.
  • Ces guides n’offrent aucune garantie générale quant à une reconnexion sans interruption, un nombre illimité de salles, une conservation infinie ou une disponibilité spécifique du service.

Vérifiez le profilCHAMPREP actif, puis assurez-vous que RTC est inclus et activé pour l’abonnement de ce profil. Un CHAMPREPcompte nouvellement créé n’y a pas automatiquement accès. Essayez de vous reconnecter si la session a expiré. Si la configuration semble correcte, contactez le service d’assistance en indiquant l’heure et l’erreur affichée.

Consultez le code d’erreur (X-Error-Code), expiration/révocation de la clé, portée requise, sélection du projet, état des ressources et quota du forfait. Copiez les UUID depuis la console ou API plutôt que d’utiliser des noms. Les propriétés JSON inconnues sont rejetées. Ne réessayez pas à plusieurs reprises en cas d’erreur d’autorisation et n’ajoutez pas de portées non pertinentes.

Une salle se connecte mais je n’entends ni ne vois personne

Section intitulée « Une salle se connecte mais je n’entends ni ne vois personne »
  • Vérifiez qu’au moins un participant est en train de publier et que son micro n’est pas coupé.
  • Vérifiez les autorisations d’accès au microphone et à la caméra dans le navigateur et le système d’exploitation, ainsi que les appareils physiques sélectionnés.
  • Un jeton en lecture seule ne permet pas de publier. Votre application ne doit pas proposer à cet utilisateur de contrôle de publication.
  • Dans un client personnalisé, joignez les pistes audio et vidéo et gérez les restrictions de lecture automatique du navigateur à l’aide d’une action de l’utilisateur.
  • Un état de signalisation connecté ne prouve pas à lui seul que le flux multimédia est actif. Testez avec deux participants autorisés sur des appareils ou des réseaux différents.

La connexion réseau est mauvaise ou la reconnexion échoue

Section intitulée « La connexion réseau est mauvaise ou la reconnexion échoue »

Essayez Faible bande passante et envisagez une publication en audio uniquement. Vérifiez si le réseau autorise les services de signalisation et de relais renvoyés dans la réponse d’authentification. Utilisez un autre réseau pour distinguer un problème de pare-feu local d’un problème de service ; ne désactivez pas les contrôles de sécurité de manière aveugle.

Votre point de connexion doit générer de nouveaux identifiants lors de la reconnexion. La réutilisation d’un jeton expiré ou déjà utilisé échoue. Le nombre SDKde tentatives est limité ; affichez l’échec et proposez une reconnexion délibérée après avoir vérifié l’état de la salle et les droits d’accès.

Actualisez la liste et vérifiez l’état de la tâche. Uniquement ready les pistes sont téléchargeables. Commencez l’enregistrement après la publication par les participants souhaités ; les pistes démarrées en retard ne sont pas automatiquement incluses. Une réponse d’arrêt signifie que la finalisation a été demandée, mais n’est pas terminée. Demandez une nouvelle URL de téléchargement si la précédente a expiré.

Pour les tâches ayant échoué, conservez l’identifiant de l’enregistrement et l’horodatage à l’intention du service d’assistance. Ne créez pas à plusieurs reprises de nouvelles tâches sans vérifier si une tâche antérieure est encore active.

Des événements de webhook sont manquants ou rejetés

Section intitulée « Des événements de webhook sont manquants ou rejetés »

Vérifiez que votre récepteur accepte les requêtes POST HTTPS sur le port 443 sans redirection et que le point de terminaison est activé et abonné au type d’événement. Envoyez un événement de test et consultez le journal de livraison, puis vérifiez le secret, la clé du schéma de signature, la vérification exacte du corps brut et le décalage d’horloge. Autorisez les événements en double sans répéter leurs effets secondaires. Voir Dépannage des webhooks.

Utilisez le CHAMPREP page de contact. Indiquez l’ horodatage et le fuseau horaire, l’opération concernée, le navigateur/appareil, l’identifiant de la ressource le cas échéant, le X-Request-Id de la requête ayant échoué, ainsi qu’un code d’erreur ou un statut HTTP expurgé. N’incluez jamais de mots de passe, API de clés, de jetons de participant, d’URL de téléchargement, de secrets de signature ou de fichiers multimédias privés.