Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Cache du shader

Grâce à la mise en cache des shaders, votre application peut éviter une recompilation coûteuse des shaders lors des prochaines sessions de streaming. Si votre application présente des problèmes ou des temps de chargement lents, la capture d'un cache de shaders peut améliorer considérablement l'expérience de vos utilisateurs finaux.

Avec Amazon GameLift Streams, vous pouvez capturer un cache de shaders à partir d'une session de streaming spécialement désignée. Les sessions de streaming suivantes de l'application dans tous les groupes de flux compatibles utilisent automatiquement le cache du shader capturé. L'utilisation de la fonction de mise en cache des shaders ne nécessite aucun code ni aucune autre modification de votre application.

Conditions préalables

Pour utiliser la mise en cache des shaders, vous devez remplir les conditions suivantes :

Comment fonctionne la mise en cache des shaders

Les applications graphiques telles que les jeux bénéficient des caches de shaders. Les caches évitent les tâches de traitement et de compilation répétées liées aux graphiques. Pour capturer un cache de shaders à partir de sessions de streaming désignées, Amazon GameLift Streams collecte des fichiers de cache de shaders système générés automatiquement pour votre application. Le service stocke ce cache et l'applique automatiquement aux sessions futures sur des groupes de flux compatibles. Cela réduit le temps consacré au traitement des shaders lors des sessions futures. La génération ou la consommation d'un cache de shader ne nécessite aucune modification de votre application.

Le cycle de vie de la mise en cache des shaders comporte trois étapes :

Capture d'un cache de shaders

Pour capturer un cache de shaders, procédez comme suit :

Après avoir généré un cache de shaders, vous pouvez l'améliorer en démarrant d'autres sessions avec GAMELIFT_STREAMS_PACKAGED_SHADER_CACHE_CAPTURE set to1. Ces sessions démarrent avec le cache de shader existant et produisent une version mise à jour.

Limites de taille du cache des shaders

Les caches de shader inférieurs à 10 Ko ou supérieurs à 4 Go (non compressés) sont rejetés.

Flux de travail du cache des shaders

Lorsque vous générez un cache de shader pour une application Amazon GameLift Streams existante, tous les groupes de flux associés compatibles commencent automatiquement à l'utiliser.

Pour tester le cache d'un shader avant qu'il n'affecte les sessions de production, nous vous recommandons cette approche :

Réplication du cache des shaders

Une fois la capture réussie, Amazon GameLift Streams rend automatiquement le cache du shader disponible dans chaque emplacement de diffusion actif des groupes de flux associés compatibles à l'application. Ce processus de réplication se termine généralement en quelques minutes.

Vous pouvez suivre la progression de la réplication à l'aide de ListApplicationShaderCaches l'opération API. Le Status champ de cache du shader indique l'état agrégé pour tous les emplacements du groupe de flux. Les statuts possibles sont les suivants.

Lorsque l'état est définiREADY, le cache du shader est automatiquement appliqué à toutes les nouvelles sessions de streaming de l'application.

La capacité de flux nouvellement provisionnée reçoit immédiatement le cache du shader. La capacité existante des groupes de flux peut prendre jusqu'à une heure pour obtenir le nouveau cache du shader.

Désactivation de la consommation du cache du shader

Par défaut, Amazon GameLift Streams télécharge et applique le cache du shader avant de lancer l'application. Pour désactiver ce comportement pour une session spécifique, définissez la variable d'environnement suivante :

{
  "AdditionalEnvironmentVariables": {
    "GAMELIFT_STREAMS_PACKAGED_SHADER_CACHE_IGNORE": "1"
  }
}

Pour améliorer un cache de shaders existant, fournissez uniquementGAMELIFT_STREAMS_PACKAGED_SHADER_CACHE_CAPTURE. Pour supprimer le cache existant et en récupérer un tout nouveau, saisissez à la fois GAMELIFT_STREAMS_PACKAGED_SHADER_CACHE_IGNORE etGAMELIFT_STREAMS_PACKAGED_SHADER_CACHE_CAPTURE.

Compatibilité avec le cache des shaders

Vous pouvez associer une application à plusieurs groupes de flux. Pour savoir à quels groupes de flux votre application est actuellement associée, utilisez l'opération GetApplication API et consultez le AssociatedStreamGroups champ.

Tous les groupes de flux associés ne sont pas nécessairement compatibles avec un cache de shaders collecté. Vous pouvez déterminer quels groupes de flux associés sont compatibles à l'aide de l'opération ListApplicationShaderCaches API. Dans sa réponse, le AssociatedStreamGroups champ contient uniquement les groupes de flux associés compatibles avec le cache du shader.

Le matériel graphique et les pilotes déterminent la façon dont le système compile les programmes de shader. De ce fait, les caches ne sont pas transférables entre différentes configurations matérielles et logicielles. Avec Amazon GameLift Streams, la compatibilité du cache des shaders est déterminée par les propriétés du groupe de flux utilisé lors de la capture :

En pratique, cela signifie qu'un cache de shader Amazon GameLift Streams présente les restrictions de compatibilité suivantes.

Amazon GameLift Streams détermine automatiquement cette compatibilité et utilise le cache de shader collecté uniquement avec les sessions compatibles.

Exemple : différentes classes de flux de génération

Votre application est associée à deux groupes de flux :

Le même cache de shader n'est pas compatible entre ces deux groupes de flux de générations différentes. Pour prendre en charge les deux groupes de flux, générez un cache de shader distinct pour chaque classe de flux.

Exemple : différentes versions de pilotes GPU

Vous disposez d'un groupe de flux qui utilise la classe gen6n_high stream et qui a généré un cache de shaders pour celui-ci. Plus tard, vous créerez un autre groupe de flux, en utilisant toujours la même classe de fluxgen6n_high.

Ce nouveau groupe de flux utilise désormais une version différente et plus récente du pilote GPU. En utilisant ListApplicationShaderCaches, vous découvrez que votre nouveau groupe de flux ne figure pas dans la listeAssociatedStreamGroups. Le cache de shader existant n'est donc pas compatible avec le nouveau groupe de flux. Générez un nouveau cache de shaders à l'aide du nouveau groupe de flux.

Résolution des problèmes de cache des shaders