Vous devez enregistrer votre application si vous utilisez le Styled Media Receiver ou si vous créez un Récepteur personnalisé. Une fois votre application enregistrée, vous recevez un ID application, qui est utilisé par votre application émettrice pour effectuer des appels d'API (pour lancer une application Web Receiver, par exemple).
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 de style à l'interface utilisateur du lecteur multimédia et utilise une constante fournie comme ID d'application.
Vous devez également enregistrer votre appareil Google Cast pour qu'il puisse accéder à votre application Web Receiver avant de la publier. Une fois votre application réceptrice publiée, elle est accessible à tous les appareils Google Cast.
Applications
Enregistrer votre application vous permet de la tester avec 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 Styled Media Receiver ou un Custom Receiver pour recevoir un ID d'application utilisé avec les appels d'API de l'application émettrice.
Pour enregistrer votre application Cast:
- Connectez-vous à la console développeur du SDK Google Cast.
- Sur la page Vue d'ensemble ou Applications, cliquez sur 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 modèles d'interaction qui ne sont pas fournis par le Styled Media Receiver. Il peut également être nécessaire de sélectionner "Récepteur personnalisé" si votre type de contenu ne figure pas parmi les types de médias compatibles avec Styled Media Receiver.
Notez que cette option nécessite de créer une application Web complète pour l'application Web Receiver.
Pour en savoir plus, consultez Application de récepteur personnalisée.
Récepteur multimédia stylisé
Sélectionnez cette option si votre application diffuse du contenu vidéo ou audio à l'aide de l'un des types de contenu multimédia 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 l'UI du lecteur multimédia par défaut.
Les styles personnalisés que vous pouvez fournir vous permettent de définir l'apparence de divers é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 de récepteur.
Pour en savoir plus, consultez Styled Media Receiver (Récepteur multimédia stylisé).
Renseignez les informations sur votre application Web Receiver:
Dans le champ Name (Nom), saisissez le nom de votre application.
Il s'agit du nom de l'application tel qu'il apparaît lorsque le récepteur Web est en cours de chargement 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é, spécifiez l'URL de l'application dans le champ URL.
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 correspondre à une page HTML ou à un autre type de fichier accessible depuis un navigateur Web. Votre récepteur Web peut se trouver sur une adresse IP interne (enregistrée par NAT), 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) lors de sa publication, le contenu chargé dans l'application Web Receiver peut être diffusé via HTTP.
Pour un Styled Media Receiver, dans le champ Skin URL (URL de la peau), spécifiez l'URL de la feuille de style.
Fournissez une URL HTTPS pointant vers votre fichier CSS situé sur votre propre site Web. Pour utiliser les styles par défaut, laissez le champ vide. Vous pourrez toujours modifier cela plus tard si vous souhaitez fournir ou mettre à jour vos styles personnalisés.
Cochez ou décochez la case Compatible avec le cast relay.
Le cast par relais permet à votre récepteur Web de prendre en charge le cast à 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 en relais pour votre récepteur, décochez cette case.
Cochez ou décochez la case Compatible avec la diffusion sur des appareils audio uniquement.
Pour autoriser votre application à détecter Google Cast pour les appareils audio, cochez cette case. Pour désactiver la compatibilité avec les appareils audio uniquement, décochez cette case. Pour en savoir plus, consultez la section Appareils audio.
Cliquez sur Enregistrer.
Les informations de votre enregistrement, y compris l'ID de l'application, le nom, le type et l'état, s'affichent. Notez l'ID de l'application, car vous le fournirez avec les appels d'API Cast de votre application.
Cliquez sur OK pour revenir à la page "Applis".
Modifier les informations sur l'application
Avant de pouvoir publier votre application, vous devez fournir des informations supplémentaires. Vous pouvez également modifier les informations que vous avez fournies sur votre application lors de l'inscription.
Pour modifier les informations de l'application:
- Dans la console développeur du SDK Google Cast, sur la page Vue d'ensemble ou Applications, cliquez sur l'ID de l'application ou sur Modifier pour l'application que vous souhaitez modifier.
- Dans le champ Nom, modifiez 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 du récepteur Web que vous avez enregistrée.
- Pour les applications Styled Receiver, dans le champ URL de la peau, mettez à jour l'emplacement de la feuille de style de votre application.
Cochez ou décochez la case Compatible avec le cast relay.
Le cast par relais permet à votre récepteur Web de prendre en charge le cast à 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 en relais pour votre récepteur, décochez cette case.
Cochez ou décochez la case Prend en charge le castage sur des appareils audio uniquement.
Cochez cette case pour autoriser votre application à détecter Google Cast pour les appareils audio. Pour désactiver la compatibilité avec les appareils audio uniquement, décochez cette case. Pour en savoir plus, consultez la section Appareils audio.
Dans la section Détails de l'expéditeur, fournissez les informations suivantes pour chaque plate-forme compatible avec votre application:
Android :
- le nom complet de votre package d'application.
iOS :
- l'ID iTunes et l'ID de bundle requis par Apple.
- 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 la section Utiliser des schémas d'URL pour communiquer avec les applications.
Web:
- l'URL du site Web de votre application.
Dans la section Détails de la fiche, indiquez si vous souhaitez lister votre application sur des 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 prendre en charge les types de contenus multimédias décrits ici, ainsi que ceux implicités par d'autres paramètres. Par exemple, si votre application est compatible avec Google Cast pour l'audio et que vous sélectionnez "TV et films" ici, elle doit prendre en charge les appareils audio uniquement, comme décrit dans la section Appareils audio, ainsi que les dispositions concernant la lecture vidéo.
Pour décrire les pays dans lesquels votre application est disponible, sélectionnez le bouton radio Tous les pays ou Seulement dans certains pays. Si vous spécifiez des pays, cochez les cases correspondantes dans la liste qui s'affiche.
Dans le champ Title (Titre), saisissez un titre descriptif pour votre application.
Utilisez 50 caractères 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 Éléments graphiques, cliquez sur le signe plus pour importer l'image de l'icône de votre application.
L'image doit mesurer 512 x 512 pixels et peut avoir un arrière-plan transparent.
Sous Ajouter vos propres traductions, si vous souhaitez fournir des traductions pour les champs Titre et Description, sélectionnez la langue dans le menu déroulant, cliquez sur Ajouter, puis saisissez le texte traduit dans la boîte de dialogue qui s'affiche. Vous pouvez également importer une image pour l'icône spécifique à cette traduction.
Lorsque vous avez terminé de modifier les informations de votre application, cliquez sur Enregistrer.
Publiez votre application
La publication de votre application la rend disponible pour tous les appareils Cast du monde entier. Une fiche est également créée pour votre application sur les propriétés Google, comme le site de fiches chromecast.com/apps, où 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îtra sur chromecast.com/apps une fois publiée.
Pour publier votre application:
Dans la console développeur du SDK Google Cast, sur la page Overview (Vue d'ensemble) ou Applications (Applications), cliquez sur Publish (Publier) pour l'application que vous souhaitez publier.
Si les informations de votre application sont complètes, un écran d'aperçu s'affiche avec les informations que vous avez saisies dans Modifier les informations de l'application. Si ce n'est pas le cas, un message s'affiche, indiquant les informations que vous devez fournir.
Vous pouvez cliquer sur Modifier pour revenir en arrière et modifier les informations.
Si vous êtes prêt à publier votre application, cliquez sur Publier.
Statistiques
La console développeur du SDK Google Cast permet de suivre 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 multimédia (en minutes) par session
Si la plate-forme Autre s'affiche 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 (Chromecast ou appareil Android TV, par exemple) 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 de récepteur Web non publiée pendant le développement, vous devez enregistrer l'appareil avec votre application. L'enregistrement permet également d'accéder au récepteur à partir d'une fenêtre de navigateur distante pour le débogage (voir la section 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 de l'appareil Cast.
Sur votre ordinateur, ouvrez un navigateur Web compatible avec 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 ne s'agit que d'un nom convivial pour votre appareil (il ne doit pas nécessairement correspondre au nom que vous lui avez attribué lors de la configuration de l'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 le câble d'alimentation ou 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 le bouton Cast (Caster) (comme si vous castiez cette page).
La requête affiche Onglet Cast et liste les appareils disponibles.
Dans le menu déroulant, sélectionnez l'appareil pour lequel 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 par les haut-parleurs du téléviseur (pour aider à distinguer les zéros et les O).
- Pour les appareils audio, le numéro de série est lu à voix haute sur l'enceinte sur laquelle la diffusion est effectuée.
Numéro de série du logiciel Android TV
Les appareils Android TV (ATV) sont associés à plusieurs numéros de série. Vous pouvez obtenir le numéro de série du logiciel (Cast) en castant la page de la console de développement Cast sur l'appareil ATV, comme indiqué ci-dessus, ou en mettant l'appareil ATV en mode développeur et en recherchant le numéro de série du logiciel dans les paramètres Cast.
Pour mettre votre appareil ATV en mode développeur, accédez à Paramètres > Système > À propos > Build de l'OS Android TV, puis cliquez plusieurs fois sur le build jusqu'à ce que l'appareil vous informe que vous êtes en mode développeur. Pour trouver le numéro de série en mode développeur, accédez à Paramètres > Préférences relatives aux appareils > Google Cast ou Paramètres > Système > Cast, selon le modèle de votre ATV. Le numéro de série du logiciel s'affichera.
Notez que lorsque vous rétablissez la configuration d'usine d'un appareil ATV, le numéro de série logiciel change. Après une réinitialisation d'usine, suivez les étapes ci-dessus pour trouver le numéro de série logiciel et réenregistrer le nouveau numéro de série logiciel de l'appareil dans la console du développeur Cast.
Problèmes liés au compte
Je souhaite résilier mon inscription à la console développeur Google Cast
Les frais d'inscription de compte de développeur de 5 $ne sont pas remboursables.
Je ne parviens plus à accéder à la console développeur de 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 plusieurs cas de non-respect de nos Conditions d'utilisation ou de nos Règles relatives au contenu, répondez à cet e-mail si vous avez besoin de plus de précisions.
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 graves ou répétées des règles peuvent entraîner la clôture de votre compte de développeur.
Dans le cas d'une suppression, les utilisateurs ne pourront plus voir ni accéder à l'application supprimée. Si vos identifiants de développeur sont encore en règle avec Google Cast et si 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.