Passer au contenu principal

Textures noires sur les appareils iOS

Problème​

Lorsque vous utilisez une haute résolution et/ou un grand nombre de textures sur certaines versions d'iOS, Safari peut manquer de mémoire GPU. Les textures peuvent s'afficher en noir ou faire planter la page.

Solutions de rechange​

  1. Réduisez la taille/résolution des textures utilisées dans votre scène (voir texture optimization)

  2. Désactiver les bitmaps sur les appareils iOS :

Il existe des bugs dans iOS 14 et iOS 15 liés aux bitmaps d'images qui peuvent causer des problèmes de texture. Désactivez les bitmaps pour éviter les textures noires et les plantages. Voir l'exemple ci-dessous :

Exemple : Désactivez les images bitmap d'iOS (ajoutez-les en haut du fichier app.js) :​

// Les bitmaps peuvent causer des problèmes de texture sur iOS. Cette solution de contournement permet d'éviter les textures noires et les plantages.
const IS_IOS =
  /^(iPad|iPhone|iPod)/.test(window.navigator.platform) ||
  (/^Mac/.test(window.navigator.platform) && window.navigator.maxTouchPoints > 1)
if (IS_IOS) {
  window.createImageBitmap = undefined
}