Vous devez enregistrer votre application si vous utilisez le récepteur multimédia stylisé ou si vous créez un récepteur personnalisé. Une fois votre application enregistrée, vous recevez un ID application, qui permet à l'application émettrice d'effectuer des appels d'API, par exemple pour lancer une application Web Receiver.
Si vous utilisez le récepteur multimédia par défaut, vous n'avez pas besoin d'enregistrer votre application. Le récepteur multimédia par défaut ne vous permet pas de fournir un style à l'interface utilisateur du lecteur multimédia et il utilise une constante fournie comme ID application.
Vous devez également enregistrer votre appareil Google Cast pour qu'il puisse accéder à votre application Web Receiver avant de le publier. Une fois votre application réceptrice publiée, elle sera disponible pour tous les appareils Google Cast.
Applications
L'enregistrement de votre application vous permet de la tester sur votre appareil Cast enregistré avant de la publier. La publication de l'application la rend disponible pour tous les appareils Cast.
Enregistrer votre application
Vous devez enregistrer un récepteur multimédia stylisé ou un récepteur personnalisé pour recevoir un ID application utilisé avec les appels d'API de l'application émettrice.
Pour enregistrer votre application Cast:
- Connectez-vous à la console du SDK Google Cast.
- Sur la page Overview ou Applications, cliquez sur Add New Application (Ajouter une application).
Sélectionnez le type d'application Web Receiver que vous utiliserez:
Récepteur personnalisé
Sélectionnez cette option si votre application nécessite des composants d'interface utilisateur ou des schémas d'interaction qui ne sont pas fournis par Styled Media Receiver. Vous devrez peut-être également sélectionner le récepteur personnalisé si votre type de contenu ne figure pas dans la liste des types de médias compatibles avec le récepteur stylisé multimédia.
Sachez que cette option nécessite la création d'une application Web complète pour l'application Web Receiver.
Pour en savoir plus, consultez Application du récepteur personnalisé.
Récepteur multimédia stylisé
Sélectionnez cette option si votre application diffuse du contenu vidéo ou audio en streaming à l'aide de l'un des types de contenus multimédias compatibles et que vous souhaitez fournir une interface utilisateur sur le téléviseur qui utilise l'UI du lecteur multimédia par défaut ou un ensemble de styles personnalisés en plus de celle du lecteur multimédia par défaut.
Les styles personnalisés que vous pouvez fournir vous permettent de définir l'apparence de différents éléments de l'interface utilisateur du lecteur (tels que l'écran de démarrage et la barre de progression) simplement en fournissant un fichier CSS. Vous n'avez pas besoin de créer une application réceptrice.
Pour en savoir plus, consultez Récepteur multimédia stylisé.
Saisissez les informations concernant votre application Web Receiver:
Dans le champ Nom, saisissez le nom de votre application.
Il s'agit du nom de l'application tel qu'il apparaît lors du chargement de Web Receiver ou à l'état inactif si vous utilisez le Récepteur multimédia stylisé. Si vous utilisez un récepteur personnalisé, la valeur de ce champ est la valeur par défaut de l'état de l'application, si elle n'est pas définie à l'aide de la méthode
setApplicationState.Spécifiez l'apparence de l'application Web Receiver:
Pour un récepteur personnalisé, dans le champ URL, spécifiez l'URL de l'application.
Saisissez une URL que l'appareil Google Cast doit demander lors du chargement de votre application Web Receiver. Pendant le développement, l'URL peut utiliser HTTP, mais lorsque l'application est publiée, elle doit utiliser HTTPS. L'URL peut renvoyer vers une page HTML ou un autre type de fichier accessible à partir d'un navigateur Web. Vous pouvez utiliser une adresse IP interne (enregistrée en NAT) sur votre Web Receiver, mais pas sur localhost, car il s'agit rarement d'un domaine de premier niveau. Bien que l'application Web Receiver doive être diffusée via SSL (HTTPS) lorsqu'elle est publiée, le contenu chargé dans l'application Web Receiver peut être diffusé via HTTP.
Pour un récepteur multimédia stylisé, indiquez l'URL de la feuille de style dans le champ URL de l'habillage.
Indiquez une URL HTTPS qui redirige vers votre fichier CSS situé sur votre propre site Web. Pour utiliser les styles par défaut, laissez le champ vide. Vous pourrez toujours le modifier plus tard si vous souhaitez fournir ou mettre à jour vos styles personnalisés.
Cochez ou décochez la case Compatible avec la diffusion par relais.
La diffusion par relais permet à votre récepteur Web de caster des contenus à partir d'expéditeurs qui ne sont pas connectés au même réseau Wi-Fi que le récepteur. Pour désactiver la diffusion par relais sur votre récepteur, décochez cette case.
Cochez ou décochez la case Compatible avec la diffusion sur des appareils audio uniquement.
Pour permettre à votre application de détecter Google Cast pour les appareils audio, cochez cette case. Pour désactiver la prise en charge des appareils audio uniquement, décochez cette case. Pour en savoir plus, consultez Appareils audio.
Cliquez sur Enregistrer.
Les détails de votre enregistrement, y compris l'ID application, le nom, le type et l'état, s'affichent. Notez l'ID application, car vous le fournirez avec les appels d'API Cast de votre application.
Cliquez sur OK pour revenir à la page "Applications".
Modifier les informations de l'application
Avant de pouvoir publier votre application, vous devez fournir des informations supplémentaires. Vous pouvez également mettre à jour les informations que vous avez fournies à propos de votre application lors de l'enregistrement.
Pour modifier les informations d'une application:
- Dans la console de développement du SDK Google Cast, à partir des pages Vue d'ensemble ou Applications, cliquez sur l'ID d'application ou sur Modifier à côté de l'application à modifier.
- Dans le champ Name (Nom), mettez à jour le nom que vous avez fourni lors de l'enregistrement de l'application.
- Pour les applications de récepteur personnalisé, dans le champ URL, mettez à jour l'emplacement de l'application Web receiver que vous avez enregistrée.
- Pour les applications Récepteur stylisé, mettez à jour l'emplacement de la feuille de style de votre application dans le champ URL d'apparence.
Cochez ou décochez la case Compatible avec la diffusion par relais.
La diffusion par relais permet à votre récepteur Web de diffuser des contenus depuis des expéditeurs qui ne sont pas connectés au même réseau Wi-Fi que le récepteur. Pour désactiver la diffusion par relais pour votre récepteur, décochez cette case.
Cochez ou décochez la case Compatible avec les appareils audio uniquement.
Cochez cette case pour permettre à votre application de détecter Google Cast pour les appareils audio. Pour désactiver la compatibilité avec les appareils en mode audio uniquement, décochez cette case. Pour en savoir plus, consultez la section Appareils audio.
Dans la section Informations sur l'expéditeur, fournissez les informations suivantes pour chaque plate-forme compatible avec votre application:
Android :
- le nom complet du package de votre application.
iOS :
- L'identifiant iTunes et l'ID du bundle requis par Apple.
- Indiquez l'URI de lancement de l'application, à l'aide de l'URI utilisé par l'application Google Home pour lancer votre application. Pour en savoir plus sur le format d'URI requis, consultez Utiliser des schémas d'URL pour communiquer avec les applications.
Web:
- l'URL du site Web de votre application.
Dans la section Listing Details (Détails de la fiche), indiquez si vous souhaitez afficher votre application sur les propriétés Google telles que chromecast.com/apps..
Dans le menu déroulant Catégorie, sélectionnez la catégorie qui décrit le mieux votre application.
Remarque:Votre application doit être compatible avec les types de médias décrits ici, ainsi qu'avec ceux qu'impliquent d'autres paramètres. Par exemple, si votre application est compatible avec Google Cast pour l'audio et que vous sélectionnez "Télévision et films" ici, elle doit être compatible avec les appareils qui ne diffusent que l'audio, comme décrit dans la section Appareils audio, ainsi que les dispositions pour la lecture vidéo.
Pour décrire les pays dans lesquels votre application est disponible, sélectionnez la case d'option Tous les pays ou Uniquement dans les pays sélectionnés. Si vous spécifiez des pays, cochez les cases correspondantes dans la liste qui s'affiche.
Dans le champ Title (Titre), indiquez un titre descriptif pour votre application.
Utilisez 50 caractères au maximum. Par exemple, "YouTube".
Dans le champ Description, saisissez une description de votre application.
Utilisez 80 caractères maximum. Par exemple, "Profitez de vos chaînes YouTube préférées sur le meilleur écran de la maison".
Dans la section Graphismes, cliquez sur le signe plus pour importer l'image d'icône de votre application.
L'image doit mesurer 512 x 512 pixels et peut présenter un arrière-plan transparent.
Sous Add Your Own Translations (Ajouter vos propres traductions), si vous souhaitez fournir des traductions pour les champs Title et Description, sélectionnez la langue dans le menu déroulant, cliquez sur Add (Ajouter), puis saisissez le texte traduit dans la boîte de dialogue qui s'affiche. Vous pouvez également importer une image de l'icône spécifique à cette traduction.
Lorsque vous avez terminé de mettre à jour les informations de votre demande, cliquez sur Enregistrer.
Publier l'application
En publiant votre application, vous la rendez disponible sur tous les appareils Cast du monde entier. Il crée également une fiche pour votre application sur les propriétés Google, telles que chromecast.com/apps, sur laquelle les utilisateurs peuvent découvrir et télécharger votre application. Si vous avez choisi de lister votre application lorsque vous avez modifié les informations de l'application à l'étape 6 ci-dessus, elle apparaît sur chromecast.com/apps une fois publiée.
Pour publier votre application:
Dans la console de développement du SDK Google Cast, cliquez sur Publier sur la page Présentation ou Applications pour l'application que vous souhaitez publier.
Si les informations de votre application sont complètes, un écran d'aperçu s'affiche avec celles que vous avez saisies dans Modifier les informations de l'application. Si ce n'est pas le cas, un message s'affiche avec les informations que vous devez fournir.
Vous pouvez cliquer sur Modifier pour revenir en arrière et mettre à jour les informations.
Si vous êtes prêt à publier votre application, cliquez sur Publier.
Statistiques
La console pour développeur du SDK Google Cast suit les performances de votre application. Pour chaque application publiée sur la page "Applications" ou "Vue d'ensemble", vous pouvez consulter les données de performances en cliquant sur Afficher dans la colonne Statistiques.
Les informations suivantes sont présentées:
- Nombre de récepteurs Cast ayant lancé l'application
- Nombre de sessions lancées
- Durée moyenne de lecture de contenus multimédias (en minutes) par session
Si la mention Autre apparaît dans les statistiques, cela signifie que l'expéditeur n'a pas indiqué sa plate-forme (par exemple, si un ancien expéditeur iOS n'a pas été mis à jour).
Appareils
Par défaut, les appareils Google Cast (tels qu'un Chromecast ou un appareil Android TV) ne sont pas activés pour le développement et les tests. Pour transformer votre appareil en appareil de développement et accéder à votre application Web receiver non publiée pendant son développement, vous devez l'enregistrer dans votre application. L'enregistrement permet également d'accéder au récepteur depuis une fenêtre de navigateur distante à des fins de débogage (voir Débogage).
Pour enregistrer votre appareil Google Cast:
Configurez votre appareil Google Cast et connectez-le au même réseau Wi-Fi que votre ordinateur.
Pour en savoir plus, consultez les instructions de configuration des appareils Cast.
Sur votre ordinateur, ouvrez un navigateur Web compatible Cast.
Connectez-vous à la console développeur du SDK Google Cast.
Recherchez le numéro de série de l'appareil que vous souhaitez enregistrer.
Sur la page "Vue d'ensemble" ou "Appareils", cliquez sur Ajouter un appareil.
Saisissez le numéro de série de votre appareil.
Saisissez une description, puis cliquez sur OK.
Il s'agit simplement d'un nom convivial pour votre appareil (il ne doit pas nécessairement correspondre au nom que vous avez donné à l'appareil lors de la configuration utilisateur).
Patientez 15 minutes avant de continuer.
Une fois l'enregistrement terminé, l'état de l'appareil indique "Prêt pour les tests".
Redémarrez votre appareil Cast: débranchez l'alimentation ou le câble USB de l'appareil, puis rebranchez-le.
Trouver le numéro de série de l'appareil
Pour trouver le numéro de série d'un appareil, vous pouvez caster la page de la console de développement Cast sur l'appareil:
Cliquez sur l'icône Cast (comme si vous castez cette page).
L'invite affiche l'onglet Caster et liste les appareils disponibles.
Dans le menu déroulant, sélectionnez l'appareil dont vous souhaitez obtenir le numéro de série.
- Pour les appareils d'affichage, le numéro de série s'affiche sur l'écran du téléviseur et est lu à voix haute sur les enceintes du téléviseur (pour faire la distinction entre les zéros et les O).
- Pour les appareils audio, le numéro de série est lu à voix haute sur l'enceinte vers laquelle le contenu est diffusé.
Numéro de série du logiciel Android TV
Les appareils Android TV (ATV) sont associés à plusieurs numéros de série. Pour obtenir le numéro de série du logiciel (Cast), vous pouvez caster la page de la console de développement Cast sur l'appareil Android TV, comme indiqué ci-dessus, ou mettre l'appareil Android TV en mode développeur et rechercher le numéro de série du logiciel dans les paramètres Cast.
Pour mettre votre appareil Android TV en mode développeur, accédez à Paramètres > Système > À propos > Build de l'OS Android TV, puis cliquez sur le build à plusieurs reprises jusqu'à ce que l'appareil vous informe que vous êtes en mode développeur. Pour trouver le numéro de série une fois en mode développeur, accédez à Paramètres > Préférences relatives à l'appareil > Chromecast Intégré ou à Paramètres > Système > Caster, selon votre modèle de téléviseur. Le numéro de série du logiciel s'affiche alors.
Notez que lorsque la configuration d'usine d'un appareil Android TV est rétablie, le numéro de série du logiciel change. Après avoir rétabli la configuration d'usine, suivez les étapes ci-dessus pour trouver le numéro de série du logiciel et enregistrer à nouveau le nouveau numéro de série du logiciel de l'appareil dans la console pour les développeurs Cast.
Problèmes liés au compte
Je souhaite annuler mon inscription à la console développeur Google Cast
Les frais d'inscription de compte de développeur de 5 $ne sont pas remboursables.
Je n'arrive plus à accéder à la console pour les développeurs Google Cast
Si vous avez déjà reçu un e-mail de notre part vous informant que votre compte de développeur a été suspendu en raison de multiples infractions à nos Conditions d'utilisation ou au Règlement relatif au contenu, veuillez répondre à cet e-mail si vous avez besoin de précisions supplémentaires.
Mon application a été supprimée de Google Cast
Les applications supprimées constituent des avertissements pour non-respect des règles applicables à votre compte de développeur. Des violations flagrantes ou répétées du règlement peuvent entraîner la clôture de votre compte de développeur.
Les utilisateurs ne pourront plus afficher l'application supprimée ni y accéder. Si vos identifiants de développeur sont toujours en règle auprès de Google Cast et que la nature de votre application le permet, vous pouvez apporter des corrections et publier une nouvelle instance conforme de l'application.
Ne publiez pas à nouveau une application supprimée tant que le non-respect des règles n'a pas été corrigé.
Je souhaite modifier l'adresse e-mail associée à mon compte
Vous ne pouvez pas modifier l'adresse e-mail associée à votre compte de développeur Google Cast. Si vous travaillez pour une organisation, nous vous recommandons d'utiliser une adresse e-mail d'équipe pour éviter tout problème d'accès à l'avenir.
J'ai un autre problè
Veuillez consulter la page d'assistance du SDK Cast.