Tous les produits
Search
Centre de documentation

Apsara Video SDK:Démarrage rapide

Dernière mise à jour :Aug 20, 2026

Intégrez rapidement le SDK ApsaraVideo MediaBox à votre application en suivant les étapes ci-dessous.

Étape 1 : Découvrir les fonctionnalités du SDK MediaBox

Le SDK audio/vidéo MediaBox propose quatre SDK tout-en-un adaptés à différents scénarios : Basic Live, Interactive Live, Short Video et Standard.

Fonctionnalité

SDK Player

SDK Push

SDK ARTC

SDK Short Video

SDK Queen

Démarrer la diffusion en direct

Prise en charge

  • Diffusion interactive entre streamer et spectateur

  • Batailles PK inter-chaînes

Prise en charge

(édition Interactive)

Prise en charge

Appels audio/vidéo

Prise en charge

Enregistrement vidéo

Prise en charge

Montage vidéo

Prise en charge

Téléchargement de vidéos

Prise en charge

Lecture en direct

Prise en charge

Lecture VOD

Prise en charge

Retouche et effets

Prise en charge

Reconnaissance gestuelle

Prise en charge

Détourage intelligent

Prise en charge

(Facultatif) Étape 2 : Essayer la démo du SDK MediaBox

Scannez le code QR suivant pour télécharger et installer l'application de démonstration du SDK MediaBox.

image.png

Pour accéder au code source de la démo, consultez Essayer la démo.

Étape 4 : Demander une licence

Étape 1 : Créer une application

  1. Accédez à la page Mes autorisations dans la console ApsaraVideo VOD. Sous l'onglet Application Management, cliquez sur Create Application.

  2. Saisissez les informations relatives à l'application. Les applications sont classées par plateforme : Web ou Mobile.

    1. Web : Saisissez un Application Name et le Web Domain correspondant. Cochez la case I understand and agree to the compliance commitments (cliquez sur View Statement pour plus de détails), puis cliquez sur Create.

      截屏2026-01-13 16

      Directives relatives aux domaines Web

      • Exemple de domaine valide : aliyun.com.

        Important

        Pour couvrir plusieurs sous-domaines, tels que pc.aliyun.com et mobile.aliyun.com, saisissez uniquement le domaine principal aliyun.com.

      • Évitez les formats suivants :

        • Inclusion d'un préfixe de protocole : http://aliyun.com ou https://aliyun.com.

        • Inclusion d'un chemin ou d'une sous-page : aliyun.com/index ou aliyun.com/login.

        • Utilisation d'un domaine générique : *.aliyun.com ou .aliyun.com.

    2. Mobile : Sélectionnez une plateforme, saisissez un Application Name, puis indiquez le Android package name, l'iOS Bundle ID et le HarmonyOS Bundle ID correspondants pour créer l'application.

      Le HarmonyOS Bundle ID se trouve dans le champ bundleName du fichier app.json5 de votre projet. Après avoir saisi les informations, cochez la case Compliance Commitment et cliquez sur Create.

      截屏2026-01-13 16

      Associer une signature d'application Android

      Remarque
      • Ce champ est obligatoire si vous sélectionnez Android comme Platform Type et cochez Bind Signature.

      • L'association d'une signature renforce la sécurité en empêchant d'autres applications portant le même nom de package d'utiliser la licence.

      • Les versions plus récentes du SDK ne nécessitent pas de signature associée, notamment ApsaraVideo MediaBox v1.7.0 et ultérieures, le SDK Player v5.5.2 et ultérieur, le SDK de streaming en direct v4.4.9 et ultérieur, ainsi que le SDK Short Video v3.36.0 et ultérieur.

      Vous pouvez obtenir la valeur MD5 de la signature de votre application Android de deux manières :

      • Exécutez la commande keytool -v -list -keystore your.keystore pour afficher la valeur MD5 de la signature correspondante.

      • Depuis Android Studio : Cliquez sur Gradle dans la barre latérale droite et accédez à Tasks > android > signingReport pour l'application. Convertissez toutes les lettres de la valeur MD5 résultante en minuscules et supprimez les deux-points.

        publishNonDefault is deprecated and has no effect anymore. All variants are now published.
        AGPBI: {"kind":"warning","text":"        Using flatDirs should be avoided because it doesn't support any meta-data formats.\n                Currently detected u..."}
        AGPBI: {"kind":"warning","text":"Please remove usages of `jcenter()` Maven repository from your build scripts and migrate your build to other Maven repositories.\nThis repository is deprecated..."}
        > Task :lista...
            Variant: debug
            Config: debug
            Store: /Us...
            Alias: and
            MD5: 5A:1E...
            SHA1: 7C:D...
            SHA-256: 5...
            Valid until: Tuesday, March 1, 2044
            ----------
            Variant: release
            Config: none
            ----------
            Variant: xxx
            Config: dxxx
            Store: /Uxxx
            Alias: androiddebugkey
            MD5: 5A:1E:F4xxx
            SHA1: 7C:D8:Exxx
            SHA-256: 55:xxx
            Valid until: Tuesday, March 1, 2044
            ----------
            Variant: debugUnitTest

Étape 2 : Acheter une licence

Remarque

Si vous avez déjà acheté une licence, passez directement à l'étape Étape 3 : Associer une licence.

  1. Revenez à la page Mes autorisations, sélectionnez l'onglet Order Instances et cliquez sur Purchase License.

  2. Sur la page d'achat d'ApsaraVideo MediaBox, sélectionnez le SDK et les modules de fonctionnalités selon vos besoins métier (les droits SDK ne peuvent pas être combinés dans un seul achat), puis finalisez l'achat.

    Important

    Comme illustré dans la figure, les droits SDK doivent être achetés séparément. Par exemple, vous pouvez acheter uniquement l'édition Standard du SDK Player.image

  3. Une fois le paiement effectué avec succès, revenez à l'onglet Order Instances pour afficher votre nouvelle instance de commande.

Étape 3 : Associer une licence

  1. Revenez à la page Mes autorisations, sélectionnez l'onglet License Management et cliquez sur Bind License.

  2. Sur la page Bind License, sélectionnez l'application et la commande de licence SDK à associer. Après avoir confirmé les informations, cliquez sur Bind.

    Remarque

    Chaque commande de licence peut être associée à une seule application , couvrant soit les plateformes Web, soit les plateformes Mobile.

    Dans la section Authorized Platforms, sélectionnez les plateformes que vous souhaitez autoriser, telles que Android. Une licence mobile n'est valable que pour une application mobile.

  3. Après une association réussie, revenez à l'onglet License Management pour afficher le nom de l'application associée et ses informations d'autorisation.

Étape 4 : Obtenir les informations d'autorisation

  1. Sous l'onglet License Management, localisez l'application cible. Votre license key s'affiche en haut de la page. Cliquez sur le bouton de copie pour copier la clé. Un lien Download Certificate est disponible sous chaque nom d'application dans la liste.

  2. Après avoir confirmé les détails de l'autorisation, cliquez sur Download Certificate pour enregistrer le fichier de licence sur votre machine locale. Enregistrez également la clé de licence pour l'utiliser lors de l'intégration de l'application. Pour obtenir des instructions sur la configuration du fichier de licence, consultez la rubrique Intégrer une licence.

Étape 5 : Intégrer le SDK et configurer la licence

Pour des instructions détaillées, consultez la rubrique Intégration du SDK tout-en-un.

Étape 6 : Implémenter la logique métier

Pour plus d'informations, consultez la documentation relative à l'intégration par module.