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 qui lui permet 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 utilise une constante fournie comme ID application.
En outre, vous devez enregistrer votre appareil Google Cast afin qu'il puisse accéder à votre application Web Receiver avant de le publier. Une fois votre application réceptrice publiée, elle est 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 styled Media receiver ou un récepteur personnalisé pour recevoir un ID d'application utilisé avec les appels d'API de l'application émettrice.
Pour enregistrer votre application Cast, procédez comme suit:
- Connectez-vous à la console développeur du SDK Google Cast.
- Sur la page Présentation 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 "Custom Receiver" si votre type de contenu ne figure pas dans la liste des types de contenus multimédias compatibles avec Styled Media Receiver.
Sachez 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 contenus multimédias compatibles et que vous souhaitez fournir une interface utilisateur sur le téléviseur qui utilise l'interface par défaut du lecteur multimédia ou un ensemble de styles personnalisés en plus de celle 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 réceptrice.
Pour en savoir plus, consultez Récepteur multimédia stylisé.
Renseignez les informations concernant 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 lors du chargement du 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 correspond à 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 en 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 cette application peut être diffusé via HTTP.
Pour un récepteur multimédia stylisé, spécifiez l'URL de la feuille de style dans le champ Skin URL (URL de l'habillage).
Fournissez une URL HTTPS qui redirige vers le fichier CSS situé sur votre site Web. Pour utiliser les styles par défaut, laissez le champ vide. Vous pourrez toujours modifier ce paramètre ultérieurement si vous souhaitez fournir ou mettre à jour vos styles personnalisés.
Cochez ou décochez la case Prise en charge de la diffusion par relais.
La diffusion par relais permet à votre récepteur Web de caster du contenu à 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 pour 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 compatibilité avec les 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, le nom, le type et l'état de l'application, 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 sur 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 sur votre application lors de l'enregistrement.
Pour modifier les informations de l'application:
- Dans la console développeur du SDK Google Cast, sur la page Présentation ou Applications, cliquez sur l'ID application ou sur Modifier pour l'application que vous souhaitez 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 de type "Récepteur stylisé", mettez à jour l'emplacement de la feuille de style de votre application dans le champ Skin URL (URL de l'habillage).
Cochez ou décochez la case Prise en charge de la diffusion par relais.
La diffusion par relais permet à votre récepteur Web de diffuser du contenu provenant 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 pour 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 compatibilité avec les appareils audio uniquement, décochez cette case. Pour en savoir plus, consultez Appareils audio.
Dans la section Détails de l'expéditeur, indiquez 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 du bundle requis par Apple.
- L'URI de lancement de l'application, en utilisant 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 Informations sur l'application, indiquez si vous souhaitez répertorier votre application sur les propriétés Google telles que chromecast.com/apps..
Dans le menu déroulant Category (Catégorie), sélectionnez la catégorie qui décrit le mieux votre application.
Remarque:Votre application doit être compatible avec les types de contenus décrits ici, ainsi que ceux impliqués par 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", votre application doit être compatible avec les appareils en mode audio uniquement, comme décrit dans la section Appareils audio et conformément aux dispositions pour la lecture des vidéos.
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 maximum. Par exemple, "YouTube".
Dans le champ Description, saisissez une description de votre application.
Utilisez 80 caractères au maximum. Par exemple, "Profitez de vos chaînes YouTube préférées sur le meilleur écran de la maison".
Dans la section Graphics (É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 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 pour l'icône spécifique à cette traduction.
Une fois les informations de votre application mises à jour, cliquez sur Enregistrer.
Publier l'application
En publiant votre application, vous la rendez disponible pour tous les appareils Cast dans le monde entier. Une fiche est également créée pour votre application sur les propriétés Google, comme la fiche chromecast.com/apps, sur laquelle les utilisateurs peuvent découvrir et télécharger votre application. Si vous avez choisi de présenter votre application lorsque vous avez modifié les informations de l'application à l'étape 6 ci-dessus, elle s'affichera sur chromecast.com/apps une fois qu'elle aura été publiée.
Pour publier votre application:
Dans la console développeur du SDK Google Cast, sur la page Présentation ou Applications, cliquez sur 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 Edit application information (Modifier les informations de l'application). Si ce n'est pas le cas, un message s'affiche et contient 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 développeur du SDK Google Cast assure le suivi des performances de votre application. Vous pouvez consulter les données de performances de chaque application publiée sur la page "Applications" ou "Présentation" 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
- Temps moyen de lecture des contenus multimédias (en minutes) par session
Si une plate-forme Autre apparaît dans les statistiques, cela signifie que l'émetteur n'a pas indiqué sa plate-forme (par exemple, si un ancien émetteur 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 ni les tests. Pour transformer votre appareil en appareil de développement et accéder à votre application Web Receiver non publiée pendant le développement, vous devez enregistrer l'appareil auprès de votre application. L'enregistrement permet également au récepteur d'être accessible à partir d'une fenêtre de navigateur à distance à des fins de débogage (voir Déboguer).
Pour enregistrer votre appareil Google Cast, procédez comme suit:
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 "Overview" (Aperçu) ou "Devices" (Appareils), cliquez sur Add New Device (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 de l'utilisateur).
Patientez quinze 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 développeur Cast sur l'appareil:
Cliquez sur l'icône Cast (comme si vous castez cette page).
L'invite affiche Caster l'onglet et répertorie 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 sur les enceintes du téléviseur (pour aider à 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 sur laquelle la diffusion est effectuée.
Numéro de série du logiciel Android TV
Les appareils Android TV sont associés à plusieurs numéros de série. Vous pouvez obtenir le numéro de série du logiciel (Cast) soit en castant la page de la console de développement Cast sur l'appareil Android TV, comme indiqué ci-dessus, soit en mettant l'appareil Android TV en mode développeur et en recherchant 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 à Settings > System > About > Android TV OS build (Paramètres > Système > À propos > Build de l'OS Android TV), puis cliquez sur le build plusieurs fois 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 > Cast, selon le modèle de votre véhicule Android TV. Le numéro de série du logiciel s'affiche alors.
Notez que lorsqu'un appareil Android TV est réinitialisé, 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 réenregistrer le nouveau numéro de série du logiciel de l'appareil dans la console développeur Cast.
Problèmes liés au compte
Je souhaite annuler mon inscription à la console développeur de Google Cast
Les frais d'inscription de compte de développeur d'un montant de 5 $ne sont pas remboursables.
Je ne parviens plus à accéder à la console développeur 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 manquements répétés à nos Conditions d'utilisation ou à notre Règlement relatif au contenu, répondez à 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 manquements au règlement applicable à votre compte de développeur. Des violations flagrantes ou répétées des règles peuvent entraîner la clôture de votre compte de développeur.
Une suppression signifie que les utilisateurs ne peuvent pas voir l'application supprimée ni y accéder. Si vos identifiants de développeur sont toujours en règle avec 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 problème de non-respect des règles n'a pas été résolu.
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.