Si vous avez une question qui ne figure pas sur cette page, contactez-nous en utilisant les coordonnées indiquées sur la page de contact de l'assistance.
Cette page peut être mise à jour avec les questions fréquentes au fur et à mesure qu'elles sont reçues.
Général
Cette section inclut toutes les questions qui n'entrent pas dans une catégorie spécifique.
Puis-je tester le jeu dans l'environnement YouTube ?
Oui, utilisez le portail des développeurs et suivez les instructions de test.
Mon jeu ne s'affiche pas sur Android ou dans la suite de tests du SDK. Que dois-je faire ?
Lorsque les jeux ne s'affichent pas exclusivement sur Android ou dans la suite de tests du SDK, cela est souvent dû à la façon dont ils sont chargés dans la WebView. Pour des raisons de performances, le jeu est initialement chargé dans une WebView qui n'est pas affichée pour l'utilisateur. Par conséquent, la taille de la fenêtre d'affichage de la WebView est de zéro. Pour résoudre ce problème, nous vous recommandons de procéder comme suit :
(1) Vérifiez que le code de votre jeu s'exécute quelle que soit la taille de la fenêtre d'affichage.
(2) Vérifiez que le code de votre jeu gère le redimensionnement de la fenêtre d'affichage et qu'il n'attend pas ou n'échoue pas lorsque la taille de la fenêtre d'affichage est nulle.
Nous vous recommandons d'écouter l'événement de fenêtre resize et de ne définir la hauteur de votre jeu que lorsque window.innerHeight est différent de zéro.
Exigences techniques
Cette section inclut des questions concernant les exigences techniques des Jeux intégrés YouTube.
Puis-je bénéficier d'une exemption pour la limite de taille des fichiers individuels ?
Non. La taille de chaque fichier est une limite stricte.
Comment la taille initiale du bundle est-elle mesurée ?
La taille initiale du bundle est mesurée comme la quantité totale d'octets téléchargés par le Playable jusqu'à ce que l'événement gameReady soit appelé.
Les Jeux intégrés utilisent la compression HTTP lorsque cela est possible, ce qui signifie que la taille initiale du bundle peut être inférieure à la taille brute totale des éléments. Lorsque vous testez la taille initiale du bundle dans la suite de tests du SDK, si votre hôte local ne compresse pas les éléments, la taille peut être plus importante que celle de votre Playable une fois publié. Pour connaître la taille réelle du bundle initial diffusé pour un Playable, utilisez la suite de tests du SDK pointée vers le fichier index.html d'un build importé ou modifiez les paramètres de votre serveur local pour activer la compression gzip.
J'ai atteint ou dépassé la limite de taille d'un fichier individuel ou du bundle total. Que dois-je faire ?
Pour optimiser votre jeu et améliorer ses performances, consultez les articles suivants :
- Compression d'images
- Audits des performances
- Temps de chargement rapides
Activer la compression de texte*
Optimiser l'encodage et la taille de transfert des éléments textuels
Que faire si je ne parviens pas à respecter la limite de taille totale du bundle ?
Les utilisateurs peuvent être amenés à télécharger des assets de votre jeu chaque fois qu'ils y jouent. Pour éviter des temps de chargement longs et une utilisation importante des données, il est recommandé que la taille totale du bundle du jeu soit aussi petite que possible.
Nous encourageons les jeux à utiliser le chargement différé ou d'autres types de chargement incrémentiel des assets au cours de chaque session de jeu à mesure que les utilisateurs progressent, ou à diviser les assets par niveau pour permettre leur téléchargement en petites quantités réparties sur une longue session. Dans ce type de situation, une taille de bundle totale plus importante ne dégrade pas l'expérience utilisateur. Elle peut même l'améliorer en permettant d'inclure plus de contenu dans votre jeu avec une empreinte par utilisateur plus faible. Si vous pensez que votre jeu fonctionne de cette manière et qu'il justifie une taille de bundle totale plus importante, contactez-nous via notre page de contact de l'assistance pour discuter de votre cas d'utilisation.
Mes analyses internes peuvent-elles être exclues des exigences d'appel externe ?
Non. Les Jeux intégrés ne doivent pas effectuer d'appels externes pour le moment. Indiquez à votre responsable Partenaire le type d'analyse qui vous intéresse afin que les futures fonctionnalités de cet espace puissent être priorisées.
Le jeu récupère les données et les niveaux à partir d'une base de données distante. Est-ce acceptable ?
Pour le moment, non. Toutefois, nous testons l'accès aux données à distance avec certains titres. Aujourd'hui, toutes les données du jeu doivent être incluses dans le bundle du jeu. Si vous souhaitez mettre à jour ou actualiser les assets ou le contenu de votre jeu, utilisez les coordonnées de la page de contact de l'assistance pour envoyer un bundle de jeu actualisé ou pour en savoir plus si vous souhaitez participer à notre programme pilote.
Une erreur s'affiche concernant le non-respect de la Content Security Policy pour l'exécution de scripts intégrés
Cela se produit lorsque vous utilisez JavaScript pour créer et ajouter une balise <script> à votre page. Pour des raisons de sécurité, YouTube utilise une Content Security Policy (CSP) qui exige que les scripts disposent d'un code de sécurité spécial appelé "nonce". YouTube ajoute automatiquement ce code aux scripts de votre fichier HTML, mais vous devez l'ajouter manuellement à tous les scripts que vous créez avec du code.
Lorsque vous générez des tags de script de manière programmatique à l'aide de JavaScript, vous devez trouver le nonce de votre page et l'appliquer à votre nouvel élément de script.
Exemple :
const script = document.createElement('script');
script.src = '...';
// Find the nonce from the main page and apply it
script.nonce = document.querySelector('script[nonce]')?.nonce;
document.head.appendChild(script);
Vous pouvez tester les configurations hors connexion en suivant les consignes spécifiées dans les instructions de la suite de tests.
Intégration d'un SDK
Cette section inclut toutes les questions concernant les API du SDK Playables.
Je n'ai pas obtenu la certification en raison de problèmes d'intégration audio. Que dois-je corriger ?
Le problème audio le plus courant concerne les jeux qui attendent une interaction de l'utilisateur avant de lancer la lecture. Toutefois, les jeux intégrés YouTube peuvent être mis en avant automatiquement. Le jeu doit donc gérer ce cas de figure.
Pour obtenir un exemple de configuration audio, consultez les exemples.
Unity
Cette section inclut toutes les questions concernant l'intégration de jeux Unity existants au SDK Jeux intégrés YouTube. Pour obtenir des exemples d'utilisation du SDK et du wrapper Unity, consultez la documentation sur le wrapper Unity pour les jeux intégrés YouTube.
Puis-je utiliser la précompression Unity ?
Nous vous déconseillons de précompresser vos assets. La taille initiale requise pour le bundle utilise la taille après compression, et les fichiers importés seront compressés après l'ingestion. Si vous devez toujours précompresser les fichiers, consultez le reste de cette section ou contactez l'équipe d'assistance sur notre page de contact de l'assistance pour discuter de la meilleure option pour votre jeu.
Certains jeux devront utiliser la précompression pour les fichiers .wasm ou .data d'Unity.
N'utilisez la précompression que dans les conditions suivantes, car elle peut entraîner des temps de chargement beaucoup plus lents :
- Si vous devez utiliser la précompression Unity pour respecter les exigences de taille de fichier ou de taille totale du bundle, consultez J'ai atteint ou dépassé la limite de taille de fichier ou de taille totale du bundle. Que dois-je faire ?.
- Si vous devez utiliser la précompression Unity pour que votre jeu soit certifié, vous devez respecter les exigences suivantes :
- Vous DEVEZ utiliser la précompression ZIP.
- Vous DEVEZ décompresser les fichiers manuellement dans votre script de chargement. Nous vous recommandons d'utiliser l'API Compression Streams.
Ces exigences supplémentaires découlent des limites de l'architecture de diffusion. Pour le moment, la prise en charge d'en-têtes HTTP supplémentaires ou de la compression Brotli n'est pas disponible.
Comment gérer les mises à jour de frames lorsque le jeu s'exécute en arrière-plan ?
Vous pouvez utiliser setTimeout pour gérer les mises à jour de frames lorsque le jeu est en arrière-plan.
Cela permet de contrôler des comportements tels que la mise en pause de l'audio. Vous pouvez vérifier la gestion des frames en arrière-plan en activant l'option "Exécuter en arrière-plan" dans les paramètres du lecteur.
Restrictions de mémoire pour les jeux Unity
Certains jeux dans Unity utilisent une quantité importante de mémoire, ce qui peut entraîner le dépassement des restrictions d'utilisation de la mémoire pour les jeux jouables. Il est recommandé de suivre la documentation pour les développeurs pour la mémoire dans Unity WebGL.