Aller au contenu
quest'n'click

JouerGuidePour joueursS'applique de 4.1.8

Installer le jeu comme une application

This page in EnglishCette page sur le wiki GitHub

Un jeu quest'n'click est une page web qui s’installe comme une application (une PWA, application web progressive) et se joue ensuite sans réseau. Cette page s’adresse aux joueurs : téléphones et ordinateurs, navigateur par navigateur.

Ce que vous obtenez

Une icône sur l’écran d’accueil ou parmi vos applications, qui ouvre le jeu en plein écran et en paysage, et une copie du jeu entier dans le cache du navigateur : il se joue hors ligne après la première visite. Vos sauvegardes restent sur l’appareil.

Contexte et versions

Tout jeu construit avec quest'n'click et servi en HTTPS (le jeu d’exemple est sur wanoo.github.io/quest-n-click). Ce que dit cette page vaut depuis la 4.1.8, quand l’installation, la mise à jour et la réinstallation ont été prouvées dans Chromium, WebKit et Firefox en CI ; la copie hors ligne du jeu entier existe depuis la 3.1. L’auteur d’un jeu peut choisir de ne garder en cache que les salles proches (offline: 'nearby') : le menu de pause n’a alors pas de ligne hors ligne, et une salle jamais visitée peut demander le réseau.

Prérequis

  • Un navigateur récent : Chrome, Edge ou un autre navigateur Chromium, Safari, ou Firefox.
  • Une connexion pour la première visite, assez longue pour que le jeu entier se télécharge (le menu de pause le montre).
  • Un peu de place : avec moins de 64 Mo libres, le jeu ne lance pas le téléchargement et le dit.

Où le faire

Sur l’appareil où vous jouerez, dans son navigateur. Rien à taper dans un terminal.

Étapes

  1. Ouvrez l’adresse du jeu en ligne et commencez ou continuez une partie. Depuis l’écran titre et après chaque salle, le jeu récupère d’abord la salle courante et ses voisines ; puis, quand rien ne se passe, le reste du jeu, lot par lot.
  1. Installez-le depuis votre navigateur :
    • iPhone et iPad (Safari) : le bouton Partager, puis Sur l’écran d’accueil. Ouvrez le jeu une fois depuis cette icône, en ligne.
    • Android (Chrome) : le menu (⋮), puis Installer l’application ou Ajouter à l’écran d’accueil.
    • Ordinateur (Chrome, Edge) : l’icône d’installation dans la barre d’adresse, ou le menu, puis Installer.
    • Firefox : Firefox garde la copie hors ligne dans le navigateur comme les autres ; qu’il propose d’installer la page comme une application dépend de votre version et de votre système. Le jeu hors ligne marche dans les deux cas.
  1. Attendez la copie hors ligne. Ouvrez le menu de pause : la ligne Hors ligne compte les fichiers (« 312/400… ») et affiche jeu entier en cache (dans le jeu d’exemple ; « complete » par défaut en anglais) quand chaque fichier du jeu est en cache. Un signe d’alerte (« 312/400 ⚠ ») veut dire qu’il en manque ; touchez la ligne pour réessayer. Un fichier déjà en cache n’est jamais téléchargé deux fois : le téléchargement reprend où il s’est arrêté, même après un rechargement.
  1. Vérifiez : passez en mode avion, fermez complètement le jeu, rouvrez-le. L’écran titre s’affiche, Continuer reprend votre sauvegarde, et une salle jamais visitée montre ses images et ses sons.

Un fichier en échec, un lot sauté ou un manque de place le laisse partiel, avec la raison.

Résultat attendu, et comment le vérifier

  • Le jeu s’ouvre depuis son icône, en plein écran, en paysage.
  • La ligne Hors ligne du menu de pause affiche le jeu entier en cache.
  • En mode avion, l’écran titre, votre sauvegarde et chaque salle sont là.

Erreurs fréquentes

Ce que vous voyezPourquoiQue faire
La ligne Hors ligne reste à « 0/400 » ou affiche ⚠ tout de suiteLe navigateur demande d’économiser les données (Économiseur de données, Save-Data), ou la connexion est en 2G : rien n’est téléchargé. Sous la 3G, musique et vidéo attendentPassez en Wi-Fi, puis touchez la ligne pour réessayer
⚠ avec moins de fichiers que le totalUn fichier n’a pas pu être téléchargéTouchez la ligne pour réessayer ; ce qui est déjà en cache reste
⚠ et rien ne se télécharge, même en Wi-FiMoins de 64 Mo libres sur l’appareilLibérez de la place, puis réessayez
⚠ juste après la première installationLe service worker du jeu n’a pas pris la main sur la page à tempsRechargez la page, puis réessayez depuis le menu de pause
Pas de ligne Hors ligne dans le menu de pauseLe jeu ne garde que les salles proches (offline: 'nearby')Jouez en ligne ; une salle visitée reste en cache

Plus de cas dans Dépannage pour les joueurs.

Fichiers ou données modifiés

Dans votre navigateur, pour le site du jeu seulement : le squelette de l’application et les fichiers du jeu dans le cache (Cache Storage), vos sauvegardes dans IndexedDB, vos réglages dans le stockage local. Voir Confidentialité.

Reprise ou retour arrière

Pour retirer l’application : supprimez son icône (appui long sur un téléphone ; désinstaller depuis le navigateur sur un ordinateur). Retirer l’icône peut laisser les données du site ; pour les effacer (vos sauvegardes avec), effacez les données du site dans les réglages du navigateur. Exportez d’abord une sauvegarde si vous voulez la garder (Sauvegardes).

Références