Dépannage des problèmes du SDK Push | ApsaraVideo Live - ApsaraVideo Live

Références

Références API pour le dépannage :
- Android : Basic Edition
- iOS : Basic Edition
- Flutter : Flutter Push SDK API Documentation
- Windows : Windows Push SDK API Documentation
Téléchargez le code source de la démo pour explorer l'utilisation de l'API et tester les fonctionnalités.
Pour le streaming multi-hôtes, commencez par consulter Introduction au streaming multi-hôtes et Démarrage rapide.
La documentation du ApsaraVideo MediaBox SDK couvre l'intégration et l'utilisation.

Navigation dans la console

La console ApsaraVideo Live propose des fonctionnalités de gestion des flux en direct, de gestion des applications, de centre de données et de boîte à outils.

Pour obtenir des informations sur les fonctionnalités prises en charge par la console, consultez l'Aperçu des fonctionnalités.
Pour gérer vos licences SDK, accédez à la page My Licenses dans la console.
Pour savoir comment utiliser l'outil de dépannage dans la boîte à outils, consultez la rubrique Dépannage.

FAQ

Si vous rencontrez des problèmes de configuration de licence, consultez la FAQ sur les licences.
En cas d'exceptions lors de l'ingestion de flux, utilisez l'outil de dépannage pour vérifier l'URL d'ingestion.

Assistance technique

Si ces ressources ne résolvent pas votre problème, contactez-nous pour obtenir une assistance technique.

Incluez les informations suivantes pour accélérer la résolution :

Élément	Description	Remarque
Aperçu	Décrivez le problème rencontré en une phrase.	-
Description du problème	Scénario métier Spécifiez le scénario d'utilisation du SDK, tel que le streaming en direct standard ou interactif. Informations sur le SDK Spécifiez le type et la version du SDK. Étape Indiquez quand le problème survient : lors de l'intégration ou pendant l'exécution. Description du problème Décrivez le problème en détail : interruption du flux, absence de vidéo, absence de son, etc. Reproduction Indiquez si le problème est constant ou intermittent et expliquez comment le reproduire. Répartition Fournissez la plateforme, la version du système d'exploitation, le modèle de l'appareil et la région.	Pour les problèmes liés aux licences, fournissez le nom du package de votre application et la clé de licence. Utilisez la dernière version du SDK pour bénéficier du meilleur support.
Contexte	Détails Fournissez les détails de l'environnement. URL d'ingestion et de diffusion Masquez ou anonymisez toute information sensible. Heure de survenue Journaux d'erreurs Compressez les journaux, tels que les journaux logcat ou les journaux de fichiers. Configurations Cela peut inclure le nom de l'application, le nom du package et les configurations de streaming multi-hôtes. Autres informations Cela peut inclure des captures d'écran ou des enregistrements d'écran.	Configurez la journalisation via les opérations API de la classe AlivcLiveBase avant de capturer les journaux. Consultez le code source de l'application de démo pour des exemples. Ne capturez pas les journaux de fichiers pendant un flux en direct. Chemins d'accès aux journaux de fichiers : Android : /sdcard/Android/data/${app_id}/files/ iOS : dans le répertoire sandbox Pour le streaming multi-hôtes, fournissez également : URL d'ingestion de l'hôte (incluant l'AppID, le numéro de canal et l'ID utilisateur) URL de diffusion du spectateur (incluant le domaine de lecture configuré dans la relance de flux)
Informations supplémentaires	Tout message d'erreur (si disponible, incluez les codes/messages d'erreur). Indiquez si le problème se résout automatiquement (par exemple, grâce à la reconnexion automatique). Toute autre information susceptible d'aider à identifier le problème.

Modèle de description du problème

Modèle

Title: One-sentence summary of the issue.
Business scenario: Such as standard live streaming, interactive streaming, Real-Time Streaming.
SDK version: Such as AlivcLivePusher: x.y.z or AlivcLivePusher_Interactive: x.y.z.
App/Package name: Such as LiveExample / com.example.liveapp

Issue description: For example, occasional stream interruption / Unable to pull stream / No video. Briefly describe the specific symptoms.
Reproduction: For example, intermittent or consistent.
Detailed reproduction steps:
1. 
2. 
3. 
Affected users/device distribution: Such as Android 9 and earlier / iOS / Specific regions.

Ingest URL: Paste the complete ingest URL.
Streaming URL: If applicable.
Occurrence time: Specify the exact time, or provide examples if multiple occurrences.
Network environment: Wi-Fi/4G/5G/Wired network.
Issue logs: Logcat logs, ingest/streaming logs, preferably compressed.
Screen recording/screenshots: Upload any recordings or key screenshots of abnormal behavior.
Ingest parameter configuration: Such as resolution, frame rate, and bitrate.

Error messages: If errors occurred, provide error codes or messages.
Automatic recovery from exception: For example, auto-reconnection. Describe reconnection results.
Other: Any information you think might be helpful.

Problème de streaming en direct standard

Title: Occasional stream interruption during standard live streaming.
Business scenario: Standard live streaming.
SDK version: AlivcLivePusher: x.y.z.
App/Package name: LiveExample / com.example.liveapp

Issue description: During streaming, the stream is occasionally interrupted approximately every 30 minutes, requiring manual restart.
Reproduction: Intermittent.
Detailed reproduction steps:
1. Start stream ingest.
2. Stream interruption occurs after about 30 minutes.
3. Need to ingest again to recover.
Affected users/device distribution: Android 9 and earlier, multiple device models, more frequent in Southeast Asia.

Ingest URL: rtmp://test.alivecdn.com/live/streamId?auth_key=XXX
Occurrence time: 2024-05-18 12:34
Network environment: 4G
Issue logs: See attachment logcat_20240518.zip.
Screen recording/screenshots: See attachment.
Ingest parameter configuration: Resolution 720p, bitrate 1500kbps, frame rate 30fps.

Error messages: No error messages.
Automatic recovery from exception: No, manual restart required.
Other: None.

Problème de streaming interactif

Title: CDN viewers cannot receive host's video.
Business scenario: Multi-host streaming, AUI Kits interactive streaming.
SDK version: AlivcLivePusher_Interactive: x.y.z
App/Package name: LiveExample / com.example.liveapp

Issue description: Host-side stream ingest is normal, guests can pull the stream normally, but viewers cannot see the host's video, with no error messages.
Reproduction: Consistent.
Detailed reproduction steps:
1. Host starts interactive streaming and begins stream ingest.
2. Guests receive the host's stream normally.
3. Viewers (Android/iOS) enter the channel but cannot see the host's video.
Affected users/device distribution: Consistent on both Android and iOS.

Ingest URL: artc://live.aliyun.com/push/633?timestamp=1685094092&token=fe4e674ade****6686&userId=718&sdkAppId=xxx
Streaming URL: rtmp://test.alivecdn.com/live/xxx_633_718_camera?auth_key=XXX
Configuration: Channel number 633, AppID xxx, User ID 718, Playback domain test.alivecdn.com.
Occurrence time: 2024-05-18 12:34
Network environment: Wi-Fi
Issue logs: See attachment logcat_20240518.zip.
Screen recording/screenshots: See attachment.
Ingest parameter configuration: Resolution 720p, bitrate 1200kbps, frame rate 20fps.

Error messages: None.
Automatic recovery from exception: No, need to restart streaming.
Other: No messages on viewer side. Switching networks/devices does not help.