BaronCyrus/ship-wechat-minigame

Mini-jeu WeChat : de l'enregistrement à la soumission pour examen

Objectif : Transformer le jeu Unity de l'utilisateur en mini-jeu WeChat, effectuer les formalités de qualification et les deux types d'archivage (小游戏备案 et 小程序备案), et soumettre la version pour examen jusqu'à ce que « Gestion des versions → Version en cours d'examen » affiche « En cours d'examen ».

À faire d'abord : Assurez-vous que les étapes 1 à 4 de ship-my-game sont terminées (archive de progression, canal, diagnostic, navigateur). Sinon, lisez-le d'abord.

Marquage des sources

• [Testé] : Réussi sur un vrai compte personnel.
• [Officiel] : Compilé selon la documentation officielle, avec lien.
• « Vérifié dans le backend » : Lu la page et les champs dans le vrai backend le 02/11/2026, mais non soumis.

Couverture des tests (au 08/11/2026)

• Testé : Enregistrement, activation de « l'adaptation rapide », exécution d'un package Unity 6 sur un vrai appareil, vérification des qualifications (approuvée), certification WeChat (terminée), archivage du mini-jeu (approuvé par l'autorité compétente), archivage du mini-programme (première révision de la plateforme terminée), téléchargement avec l'outil développeur, version d'essai, soumission pour examen (première fois rejetée pour écran noir à l'ouverture, corrigée avec le patch B7, soumise à nouveau, approuvée en environ 1 heure), publication d'un jeu solo avant d'obtenir le numéro d'archivage du mini-programme, soumission de matériel promotionnel (description du jeu, texte promotionnel, couverture générale, images promotionnelles verticales et horizontales, vidéo promotionnelle verticale d'écran de jeu réel) pour examen.
• Basé uniquement sur [Officiel] : Étapes après la première révision de la plateforme de l'archivage du mini-programme, téléchargement en ligne de commande, déploiement progressif, conditions de publication pour les jeux en ligne, résultats d'examen du matériel promotionnel, vidéo promotionnelle générale, compte publicitaire et réception des paiements.

Tâches personnelles

Étape	Tâche
P1	Enregistrer un compte : remplir l'email, le code d'activation, les informations réelles, scan du QR code par l'admin WeChat. Environ 20 min [Testé]
Tout le processus	Se connecter à mp.weixin.qq.com par scan QR. La session expire en moins d'un jour, il faut rescanner après expiration [Testé]
P2	Scanner pour se connecter à l'outil développeur WeChat ; décider d'activer ou non le « port de service » (paramètre de sécurité) [Testé]
P3	Tester avec un scan du code de prévisualisation via WeChat mobile. Le code expire après environ 25 minutes [Testé]
P4	Signer et soumettre les documents pour la vérification des qualifications ; certification WeChat : accepter les termes, vérification d'identité, paiement [Testé]
P5	Étape 1 de l'archivage du mini-jeu : scanner pour signer trois documents, prendre des captures d'écran dans WeChat mobile, cliquer sur le dernier « Soumettre » [Testé]
P6	Archivage du mini-programme : photos recto-verso de la carte d'identité, adresse postale précise (jusqu'au numéro de rue), deux numéros de téléphone personnels (contact principal et d'urgence) et un email, vérification faciale, cocher les conditions. Rédiger une lettre d'engagement manuscrite si la province d'archivage est le Guangdong ou le Xinjiang. Après la première révision de la plateforme, vérification par SMS du MIIT dans les 24 heures [Officiel] (Guide d'archivage, Exemples de documents)
P7	Lors du téléchargement en ligne de commande, générer la « clé de téléchargement du code du mini-programme », généralement nécessite le scan de l'admin (non testé)
P8	Cliquer sur « Soumettre » dans la barrière de soumission ; après approbation, l'utilisateur décide de la publication et confirme par scan QR de l'admin WeChat [Testé]
Après publication	Activer le compte publicitaire (流量主) : accepter le contrat publicitaire ; après activation, fournir les informations financières : nom du titulaire, numéro de carte d'identité, numéro de compte bancaire [Officiel] (Publicité, payouts.md)

Exigences techniques (référence étape 3 de l'entrée principale)

Version du moteur

• Selon l'officiel [Officiel] :
  • Supporte Unity 2018～2022 et Unity Engine (团结引擎), recommandé 2022.3 ou Unity Engine (Versions recommandées).
  • Le journal des mises à jour du SDK indique « Supporte Unity6, version préliminaire déconseillée pour une mise en ligne » (CHANGELOG).
• Testé dans ce dépôt [Testé] : Unity 6000.6 avec 12 patchs s'exécute sur un vrai appareil, les patchs sont intégrés dans les scripts. L'ancien « écran noir occasionnel sur Android » était dû au moteur n'attendant pas le bundle de ressources, la première soumission a été rejetée pour cette raison, corrigée par le patch B7 (voir build.md section 10).
• Comment choisir :
  • Nouveau projet : Utiliser 2022.3 LTS ou Unity Engine.
  • Projet Unity 6 existant : Suivre la voie des patchs de ce dépôt. Informer d'abord l'utilisateur que l'officiel ne considère cela que comme une pré-version, puis l'enregistrer dans l'archive de progression.

Module de plateforme : Support de build WebGL.

SDK

• Utiliser scripts/fetch_wxsdk.sh pour le récupérer, version fixée à v0.1.34.
• Ne pas utiliser la pré-version v0.1.35 : elle remplace le plugin par WX-WASM-SDK-V3, les patchs existants pourraient ne plus fonctionner.

AppID : Doit être celui d'un vrai mini-jeu, avec « adaptation rapide » activée. Les comptes de test ne peuvent pas exécuter les packages Unity [Testé].

Taille du package

• Limite officielle : Package principal ≤ 4 Mo, package total ≤ 30 Mo [Officiel] (Package de code).
• Lorsque les premières ressources sont dans le package, la documentation Unity les compte jusqu'à 20 Mo (UsingLoader), donc viser 20 Mo.
• Taille testée : 13～14 Mo [Testé].

Code à modifier obligatoirement (tout [Testé], voir build.md et capabilities.md) :

• Générer un sous-ensemble de polices chinoises et le définir comme police de secours.
• Utiliser WX.StorageSetStringSync pour la sauvegarde, sauvegarder immédiatement après chaque action clé.
• Éviter la zone de sécurité et le bouton capsule en haut à droite en utilisant WX.GetWindowInfo et WX.GetMenuButtonBoundingClientRect pour les calculs.
• Supprimer les liens externes, les évaluations de l'App Store, les entrées des services Google ; inclure le code Android uniquement dans #if UNITY_ANDROID.
• Le titre de la page d'accueil doit afficher le nom chinois enregistré du jeu, nécessaire pour les captures d'écran d'archivage.
• Lorsque l'ID de l'emplacement publicitaire est vide, le bouton publicitaire doit se dégrader en toute sécurité, sans erreur ni blocage.
• Démarrer le jeu dans le callback de WX.InitSDK.

Type de réseau : Décider d'abord entre « solo » ou « en ligne », avant l'archivage du mini-jeu.

• Pour les jeux solo, la directive de protection de la vie privée ne peut être réglée que sur « Ne traite aucune information utilisateur » (vérifié dans le backend).
• Par conséquent, les jeux solo ne peuvent pas utiliser les interfaces de confidentialité telles que le classement des amis, le presse-papiers, les informations utilisateur (déduction, voir console.md).

Étapes

P1 Enregistrement du compte et initialisation du backend

1. Si l'utilisateur a déjà un compte de mini-jeu, passer à l'étape 2. Sinon, suivre onboarding.md pour ouvrir la page d'enregistrement, guider l'utilisateur pour enregistrer un compte personnel, catégorie de premier niveau « Mini-jeu » [Testé].
2. Définir le nom du jeu : utiliser uniquement du chinois pour éviter les exigences de documents de propriété intellectuelle. Le nom est verrouillé après la soumission des qualifications et de l'archivage, et ne peut plus être modifié avant la fin de l'archivage du mini-programme. Pour les comptes individuels, éviter les catégories interaction culturelle, rôle, cartes [Officiel] (Paramètres de catégorie). Règles dans listing.md.
3. Activer l'adaptation rapide : « Carte des capacités du jeu → Capacités de développement → Pack d'efficacité de production → Adaptation rapide », cliquer sur « Demander immédiatement », effet immédiat [Testé].
4. Dans « Gestion du développement → Paramètres de développement → ID développeur », lire l'AppID, l'écrire dans l'archive de progression et publish/wechat/build.json [Testé].
5. Dans « Paramètres du compte → Paramètres de base », confirmer que la zone d'exploitation est « Chine continentale (région) » (vérifié dans le backend).
6. Installer la version Stable de l'outil développeur WeChat, ne pas installer Minigame Build, puis demander à l'utilisateur de se connecter par scan QR [Testé].

Critères d'achèvement :

• L'archive de progression contient l'AppID.
• L'adaptation rapide dans la page « Pack d'efficacité de production » affiche « Activée ».
• Le nom et la catégorie de service dans les paramètres de base sont remplis.
• L'outil développeur est connecté.

P2 Build et exportation

1. Installer le module WebGL, puis exécuter scripts/fetch_wxsdk.sh <projet> pour intégrer le SDK dans Packages/ et appliquer les patchs [Testé].
2. Copier scripts/ShipWeChatBuild.cs dans <projet>/Assets/Editor/. Puis écrire <projet>/publish/wechat/build.json selon templates/build.json [Testé].
3. Utiliser ../ship-my-game/scripts/make_cjk_font.py pour générer le sous-ensemble de polices chinoises, et remplir cjkFont et latinFonts dans build.json [Testé].
4. Modifier le code selon les « Exigences techniques » [Testé].
5. Exporter : Exécuter ../ship-my-game/scripts/unity_build.sh <projet> WebGL ShipWeChatBuild.Export wechat [Testé].
6. Dans l'outil développeur, « Projet → Importer un projet », sélectionner <projet>/Builds/wechat/minigame, cliquer sur « Faire confiance et exécuter », parcourir le flux principal dans le simulateur [Testé].
7. Utiliser scripts/wx_cold_start.py dans le simulateur pour reproduire une première ouverture : supprimer le cache, faire arriver le bundle de ressources avec 12 secondes de retard, compiler, lire le verdict, restaurer. L'examinateur fait exactement cela pour la première ouverture, cela ne se voit pas sur son téléphone. Voir build.md [Testé].

Critères d'achèvement :

• Le journal contient [Ship] wechat export=SUCCEED. Pour les projets Unity 6, également [Ship] framework patched et une ligne commençant par [Ship] B7.
• Reproduction de la première ouverture : le simulateur affiche d'abord la page de chargement puis la page d'accueil, wx_cold_start.py log rapporte OK, et enfin release.
• Le simulateur peut accéder à la page d'accueil, le tactile répond, la console n'affiche pas d'erreur rouge (sauf les journaux ignorables).
• La taille du package de code affichée dans le panneau de prévisualisation est dans les limites.

Détails et tableau de correspondance des patchs dans build.md.

P3 Vérification sur appareil réel

1. Basculer le panneau de prévisualisation sur « Prévisualisation par QR code ». Ne pas utiliser « Prévisualisation automatique » ou « Débogage sur appareil réel » [Testé].
2. Générer le code de prévisualisation, envoyer la capture d'écran à l'utilisateur ou le laisser scanner le code dans l'outil développeur. Le code expire après environ 25 minutes [Testé].
3. Vérifier avec l'utilisateur chaque point de la liste de vérification de build.md : son, chinois, tactile, sauvegarde persistante après fermeture, pas d'obstruction par l'encoche ou le bouton capsule, pas d'entrée inaccessible, nom chinois sur la page d'accueil.
4. Faire aussi une première ouverture sur le téléphone : supprimer d'abord le mini-jeu de « Récemment utilisés » dans WeChat, puis scanner le code. On ne sait pas encore si la suppression vide le cache des ressources, la conclusion repose sur la reproduction dans le simulateur de l'étape P2. En cas d'écran noir, s'arrêter et consulter troubleshooting.md, ne pas se fier à « Rouvrir le mini-programme » : l'examinateur ne l'ouvre qu'une fois, la première soumission a été rejetée pour cette raison [Testé].

Critères d'achèvement : L'utilisateur confirme que tous les points de la liste sont validés sur au moins un téléphone. Tester à la fois sur Android et iOS si disponibles.

P4 Champs obligatoires du backend, qualifications et certification (peut être parallélisé avec P2 et P3)

1. Indication d'âge approprié : « Paramètres du compte → Paramètres de base → Indication d'âge approprié → Configurer ». Remplir selon console.md, l'utilisateur confirme puis cliquer sur « Soumettre pour examen » (vérifié dans le backend).
2. Directive de protection de la vie privée : « Déclaration de contenu du service → Directive de protection de la vie privée → Aller perfectionner ». Pour les jeux solo, sélectionner « Ne traite aucune information utilisateur », l'utilisateur confirme puis cliquer sur « Confirmer le contenu ci-dessus » (vérifié dans le backend).
3. Soumission des qualifications : Choisir « Cas 2 : Le mini-jeu n'a pas besoin et n'aura pas besoin de paiement virtuel », les documents signés sont remplis par l'utilisateur [Testé]. Voir filing.md.
4. Certification WeChat : Effectuée par l'utilisateur [Testé]. Voir onboarding.md.
5. Vérification du nom réel du ministère de la Propagande : Aucune action nécessaire si le paiement virtuel n'est pas activé, la page indique « Aucune action requise de la part du développeur » (vérifié dans le backend).

Critères d'achèvement :

• L'indication d'âge approprié affiche « Soumis » ou « Approuvé ».
• La directive de protection de la vie privée n'affiche plus « Non mis à jour ».
• Les qualifications affichent « En cours d'examen » ou « Approuvées ».
• La certification WeChat est terminée, ou payée et en cours d'examen.

P5 Archivage du mini-jeu (小游戏备案)

1. Confirmer quatre prérequis :
   • Le nom est finalisé ;
   • Les qualifications ont été soumises ;
   • L'indication d'âge approprié a été soumise ;
   • Une version de prévisualisation existe : la page d'accueil affiche le nom chinois, la fenêtre contextuelle « Suggestions d'optimisation » est fermée.
2. Ouvrir le formulaire d'archivage, point d'entrée dans filing.md. L'étape 1 est effectuée par l'utilisateur : choisir le type de jeu et le type de réseau, puis scanner pour signer trois documents [Testé].
3. Le texte de l'étape 2 est rempli par vous. Lire d'abord le code pour vérification, puis écrire le scénario, les mécanismes de jeu et le système selon templates/filing-content.md [Testé].
4. Donner à l'utilisateur la liste des captures d'écran, lui demander de les prendre dans WeChat mobile. Vous les renommez par catégorie, utilisez la méthode de transfert local pour n'en envoyer qu'une catégorie à la fois, cliquez sur « Enregistrer » après chaque envoi, puis actualisez et vérifiez [Testé].
5. Passer la barrière de soumission : lister le contenu à soumettre à l'utilisateur, après son accord « Soumettre », cliquer sur « Suivant → Aperçu des informations → Soumettre », ou demander à l'utilisateur de le faire [Testé].

Critères d'achèvement : La page « Guide de soumission et de publication des mini-jeux » affiche « En cours d'examen par la plateforme ». Dans l'archive de progression, « En attente » mentionne la durée estimée : première révision de la plateforme 1-2 jours ouvrés, révision par l'autorité compétente 10-20 jours ouvrés.

P6 Archivage du mini-programme (ICP)

Références : Archivage du mini-programme, Guide d'archivage, Exemples de documents. Le remplissage du formulaire jusqu'à la soumission a été testé, après la première révision, suivre l'officiel.

1. Attendre que l'archivage du mini-jeu affiche « Approuvé par l'autorité compétente » et que la certification WeChat soit terminée. Lors du test, la page de guide exigeait que ces deux éléments soient accomplis avant que le bouton « Commencer l'archivage » ne devienne cliquable [Testé].
2. Avant d'ouvrir le formulaire, expliquer une fois à l'utilisateur tout ce qu'il doit préparer : photos recto-verso de la carte d'identité, adresse postale précise (jusqu'au numéro de rue), deux numéros de téléphone personnels et un email, conditions de fond pour la vérification faciale ; si la province d'archivage est le Guangdong ou le Xinjiang, rédiger d'abord une lettre d'engagement manuscrite. Dire que « Soumettre » attend votre vérification. Lors du test, l'utilisateur a soumis directement après avoir rempli [Testé]. Liste dans filing.md.
3. Depuis la page de guide, cliquer sur « Commencer l'archivage » pour ouvrir un nouvel onglet « Vérifier le type d'archivage ». Ne pas sélectionner le cas 1 ou le cas 2, ni le type d'archivage [Testé].
   • Utilisateur : Sélectionner la région, télécharger la carte d'identité, cliquer sur « Vérifier » ; remplir l'adresse, le numéro de téléphone et l'email ; scanner pour la vérification faciale ; signer la lettre d'engagement (Guangdong, Xinjiang).
   • Vous : Rédiger la « Remarque (obligatoire) » pour confirmation par l'utilisateur (l'officiel n'a pas d'exigence, non confirmé) ; vérifier la page « Aperçu des documents ».
4. Passer la barrière de soumission sur la page « Aperçu des documents » : lister le contenu du service, les remarques et les documents téléchargés à l'utilisateur ; lui demander de vérifier lui-même l'adresse et les informations de la carte d'identité ; l'utilisateur coche les conditions en bas ; cliquer après que l'utilisateur dit « Soumettre » [Testé].
5. Après la première révision de la plateforme, rappeler à l'utilisateur : après réception du SMS du 12381, effectuer la vérification sur le site d'archivage du MIIT dans les 24 heures, sinon le dossier sera renvoyé [Officiel].

Critères d'achèvement : Le backend affiche que le numéro d'archivage a été délivré ; sinon, l'archivage du mini-programme sur la page d'accueil « Archivage et certification » affiche « En cours d'examen » (testé « En cours d'examen par la plateforme »), l'archive de progression mentionne l'heure de soumission, l'étape d'examen actuelle et la durée estimée.

P7 Téléchargement de la version de développement et version d'essai [Testé]

Références : Collaboration et publication, miniprogram-ci.

1. Confirmer que l'exportation correspond à la version à soumettre : les ID des emplacements publicitaires peuvent être vides, le nom sur la page d'accueil est correct, la fenêtre contextuelle « Suggestions d'optimisation » est fermée.
2. Télécharger, choisir une des deux méthodes :
   • « Télécharger » de l'outil développeur, remplir le numéro de version et les notes [Testé] ;
   • Ligne de commande scripts/wx_ci.js upload, nécessite une clé de téléchargement et une liste blanche IP, voir automation.md (non testé).
3. Ouvrir « Gestion des versions → Version de développement », confirmer voir cette version, puis dans le menu déroulant à côté de « Soumettre pour examen », la « Sélectionner comme version d'essai », demander à l'utilisateur de scanner le code de la version d'essai pour une dernière vérification [Testé]. Détails dans review.md.

Critères d'achèvement : La liste des versions de développement contient ce numéro de version, la version d'essai peut être ouverte sur le téléphone.

P8 Barrière de soumission pour examen [Testé]

Références : Examen des versions.

1. Vérifier les prérequis :
   • L'indication d'âge approprié et la directive de protection de la vie privée sont toutes deux terminées ;
   • La version de développement a été téléchargée ;
   • Le nom affiché dans le jeu correspond au nom dans le backend.
2. Dans « Gestion des versions → Version de développement », cliquer sur « Soumettre pour examen », remplir le formulaire selon review.md. Le formulaire est dans un iframe cross-origin sur un nouvel onglet, on ne peut que prendre des captures d'écran et opérer par coordonnées.
3. Passer la barrière de soumission de l'entrée principale : lister à l'utilisateur le canal, le numéro de version, la taille du package, les notes de version, la déclaration de confidentialité et de publicité, la durée estimée de l'examen (officiellement 1 jour calendaire normal, testé 1-3 heures pour un résultat), attendre que l'utilisateur dise « Soumettre ».
4. Cliquer sur « Soumettre » dans le formulaire, dans le rappel de conformité de la vie privée cliquer sur « Continuer à soumettre », puis lire « Gestion des versions », confirmer que « Version en cours d'examen » affiche « En cours d'examen ».

Critères d'achèvement : « Version en cours d'examen » affiche « En cours d'examen ». L'archive de progression mentionne l'heure de soumission, la durée estimée, et où voir le résultat (page « Gestion des versions », message interne).

Période d'attente et après publication

Durées des éléments en attente (à écrire dans l'archive de progression « En attente »)

• Qualifications : Testé approuvé ; la page indique environ 1 jour ouvré, l'officiel indique 1-3 jours calendaires.
• Archivage du mini-jeu : Première révision de la plateforme 1-2 jours ouvrés, autorité compétente 10-20 jours ouvrés. Testé : soumis le 24/10, en « Examen par l'autorité compétente » le 31/10, approuvé le 07/11.
• Archivage du mini-programme : Officiel pour le cas 2 environ 10-30 jours ouvrés ; le backend mentionne 3-10 (page de guide) et 2-22 (fenêtre contextuelle « Archivage requis » de la page de gestion des versions), donner l'estimation la plus longue. Première révision de la plateforme 1-2 jours ouvrés, après rejet 7 jours ouvrés.
• Examen de version : Officiellement environ 1 jour calendaire ; testé deux fois, résultat le jour même, environ 3 heures (rejet) et environ 1 heure (approbation).

Choses à ne pas faire pendant l'attente

• Ne pas changer de nom, ne pas transférer de sujet : les deux archivages seront annulés, il faudra recommencer.
• Ne pas cliquer sur « Mise à jour du plugin » dans l'outil développeur : la version du plugin suit le SDK [Testé].

Choses à faire pendant l'attente : Intégrer le code publicitaire (laisser l'ID vide), faire des captures d'écran.

Publication : Après approbation, dans « Gestion des versions → Version en cours d'examen », cliquer sur « Soumettre pour publication », choisir publication totale ou progressive, puis confirmer par scan QR de l'admin WeChat. Demander d'abord à l'utilisateur avant la publication [Testé]. Les jeux solo n'ont pas besoin d'attendre le numéro d'archivage du mini-programme, testé ; les jeux en ligne doivent d'abord obtenir le numéro d'archivage selon l'officiel. Voir review.md.

Après publication

• Matériel promotionnel : Dans « Gestion du matériel promotionnel », remplir la description du jeu, la couverture générale, les images promotionnelles verticales et horizontales, le texte promotionnel et la vidéo promotionnelle. Ils déterminent l'affichage dans les résultats de recherche et la page de découverte. Chaque élément texte ne peut être modifié que 3 fois par mois, les vidéos promotionnelles 10 séries par semaine. Montrer d'abord les échantillons d'images, de vidéos et de textes à l'utilisateur, puis soumettre après son accord. Voir listing.md [Testé].
  • Lorsque le haut de la page indique qu'il manque « Vidéo promotionnelle - écran de jeu réel », enregistrer une vidéo d'écran de jeu réel selon listing.md : jeu vertical 1080×1920, 20-30 secondes, sans texte ni cadre.
• Compte publicitaire : Nécessite plus de 100 visiteurs uniques cumulés pour être activé (ou remplir les conditions du cercle de jeu). Le jour de l'activation, fournir les informations financières, puis créer un emplacement publicitaire, remplir l'ID dans le jeu, et publier une nouvelle version. Voir capabilities.md, réception des paiements dans payouts.md.
• Échec au lancement : Consulter les journaux « Temps réel » dans le backend après la publication pour le lancement qui a échoué, les enregistrer dans l'archive de progression.

En cas de rejet ou de blocage : Voir review.md et troubleshooting.md.