BaronCyrus/ship-wechat-minigame

Minijuego de WeChat: Del registro a la revisión

Objetivo: Convertir el juego Unity del usuario en un minijuego de WeChat, completar las calificaciones y dos tipos de registros (备案), y enviar la versión para su revisión hasta que aparezca "En revisión" en "Gestión de versiones → Versión en revisión".

Primero: Asegúrate de que los pasos 1 a 4 de ship-my-game estén completos (archivo de progreso, canal, chequeo, navegador). Si no, léelo primero.

Marcas de fuente

• [实测]: Probado con éxito en una cuenta personal real.
• [官方]: Basado en documentación oficial, con enlace adjunto.
• "Verificado en el panel": Se leyeron páginas y campos en el panel real el 2026-11-02, pero no se envió nada.

Alcance de las pruebas (hasta 2026-11-08)

• Probado: Registro, habilitación de "Adaptación Rápida", ejecución del paquete Unity 6 en un dispositivo real, revisión de calificaciones (aprobada), certificación de WeChat (completada), registro del minijuego (aprobado por la autoridad), registro del mini programa (aprobado en la revisión inicial de la plataforma), subida con la herramienta de desarrollador, versión de prueba, envío para revisión (primera vez rechazada por pantalla negra al abrir, corregida con el parche B7 y reenviada, aprobada en aproximadamente 1 hora), publicación del juego sin conexión antes de obtener el número de registro del mini programa, y materiales de marketing (descripción del juego, texto promocional, portada de material general, imágenes promocionales verticales y horizontales, video promocional de pantalla real vertical) enviados para revisión.
• Solo con base [官方]: Procesos posteriores a la revisión inicial del mini programa, subida por línea de comandos, lanzamiento gradual, condiciones de publicación para juegos en línea, resultados de revisión de materiales de marketing, videos promocionales generales, anuncios de '流量主' y pagos.

Asuntos personales

Etapa	Asunto
P1	Registrar cuenta: llenar correo, código de activación, información real, escanear código QR del administrador de WeChat. Aprox. 20 minutos [实测]
Todo el proceso	Iniciar sesión en mp.weixin.qq.com escaneando código QR. La sesión caduca en menos de un día, hay que volver a escanear [实测]
P2	Iniciar sesión en la herramienta de desarrollador de WeChat escaneando código QR; decidir si habilitar el "puerto de servicio" (configuración de seguridad) [实测]
P3	Usar el móvil con WeChat para escanear el código de vista previa y probar. El código caduca aprox. en 25 minutos [实测]
P4	Firmar y presentar materiales para la calificación; certificación de WeChat: aceptar acuerdo, verificar identidad, pagar [实测]
P5	Paso 1 del registro del minijuego: escanear código QR con el móvil para firmar tres documentos; tomar capturas de pantalla del registro en el WeChat móvil; hacer clic en "Enviar" al final [实测]
P6	Registro del mini programa: fotos de ambas caras del DNI, dirección de contacto detallada (hasta el número de puerta), dos números de teléfono móvil propios (responsable y contacto de emergencia) y un correo, verificación facial, marcar casilla de aceptación de términos [实测]; si la provincia de registro es Guangdong o Xinjiang, escribir una declaración jurada a mano; después de la aprobación inicial de la plataforma, completar la verificación por SMS del MIIT dentro de 24 horas [官方] (Guía de operaciones de registro, Ejemplos de materiales)
P7	Al subir por línea de comandos, generar la "Clave de carga del código del mini programa", generalmente requiere escaneo del administrador (no probado)
P8	Decir "Enviar" en la compuerta de envío; después de la aprobación, el usuario decide publicar y confirma escaneando el código QR del administrador de WeChat [实测]
Después del lanzamiento	Al habilitar '流量主', aceptar el acuerdo de publicidad; después de habilitarlo, completar los datos financieros: nombre de la cuenta, número de DNI, número de cuenta bancaria [官方] (Anuncios, payouts.md)

Requisitos técnicos (ver paso 3 de la entrada principal)

Versión del motor

• Según la documentación oficial [官方]:
  • Soporta Unity 2018~2022 y Unity Engine (Tuanjie), recomendado 2022.3 o Unity Engine (Versiones de motor recomendadas).
  • El registro de cambios del SDK dice "Soporta Unity 6, versiones de previsualización no recomendadas para lanzamiento" (CHANGELOG).
• Probado en este repositorio [实测]: Unity 6000.6 con 12 parches funciona en un dispositivo real, los parches están escritos en scripts. El anterior "pantalla negra ocasional en Android" se debía a que el motor no esperaba el paquete de recursos, corregido con el parche B7 (ver build.md sección 10).
• Cómo elegir:
  • Proyectos nuevos: Usar 2022.3 LTS o Unity Engine.
  • Proyectos Unity 6 existentes: Pueden seguir la ruta de parches de este repositorio. Primero informa al usuario de que "oficialmente solo es vista previa", luego anótalo en el archivo de progreso.

Módulo de plataforma: Soporte de compilación WebGL.

SDK

• Usar scripts/fetch_wxsdk.sh para descargarlo, versión fijada en v0.1.34.
• No usar la versión de previsualización v0.1.35: Reemplaza el plugin por WX-WASM-SDK-V3, los parches actuales podrían no funcionar.

AppID: Debe ser el AppID de un minijuego real, y debe tener habilitada la "Adaptación Rápida". Las cuentas de prueba no pueden ejecutar paquetes Unity [实测].

Tamaño del paquete

• Límite oficial: paquete principal ≤ 4 MB, paquete total ≤ 30 MB [官方] (Paquete de código).
• Cuando los recursos del primer paquete están dentro, la documentación de Unity cuenta 20 MB (UsingLoader), por lo tanto, controlar por 20 MB.
• Tamaño probado: 13~14 MB [实测].

Código que debe modificarse (todo [实测], ver build.md y capabilities.md):

• Subconjunto de fuentes CJK y establecer como fuente de respaldo.
• Guardado de datos usando WX.StorageSetStringSync, guardar inmediatamente después de cada operación clave.
• Evitar la zona segura y el botón de cápsula superior derecha usando WX.GetWindowInfo y WX.GetMenuButtonBoundingClientRect.
• Eliminar enlaces externos, valoraciones en tiendas de aplicaciones, entradas de servicios de Google; solo incluir código para Android en #if UNITY_ANDROID.
• El título de la pantalla principal debe mostrar el nombre chino registrado del juego; se necesita para las capturas de pantalla del registro.
• Cuando el ID del bloque de anuncios esté vacío, el botón de anuncio debe degradarse de forma segura, sin errores ni bloqueos.
• Iniciar el juego dentro de la devolución de llamada de WX.InitSDK.

Tipo de red: Decidir primero si es "sin conexión" o "en línea"; debe definirse antes del registro del minijuego.

• La guía de protección de privacidad para juegos sin conexión solo puede seleccionar "No se procesa información del usuario" (verificado en el panel).
• Por lo tanto, los juegos sin conexión no pueden usar interfaces de privacidad como tablas de clasificación de amigos, portapapeles o información del usuario (inferido, basado en console.md).

Etapas

P1 Inicialización de cuenta y panel

1. Si el usuario ya tiene una cuenta de minijuego, saltar al paso 2. Si no, seguir onboarding.md para abrir la página de registro, registrar una cuenta personal con categoría principal "Minijuego" [实测].
2. Definir el nombre del juego: usar solo caracteres chinos para evitar requisitos de materiales de derechos de autor. El nombre queda bloqueado después de enviar la calificación y el registro, y no se puede cambiar hasta que se complete el registro del mini programa. Al elegir la categoría, evitar "interacción cultural", "rol" y "cartas" para cuentas personales [官方] (Configuración de categorías). Reglas en listing.md.
3. Habilitar "Adaptación Rápida": "Mapa de capacidades del juego → Capacidades de desarrollo → Paquete de mejora de producción → Adaptación Rápida", hacer clic en "Solicitar ahora", efectivo de inmediato [实测].
4. En "Gestión de desarrollo → Configuración de desarrollo → ID de desarrollador", leer el AppID, escribirlo en el archivo de progreso y en publish/wechat/build.json [实测].
5. En "Configuración de cuenta → Configuración básica", confirmar que la región de operación sea "China continental" (verificado en el panel).
6. Instalar la versión Stable de la herramienta de desarrollador de WeChat, no la versión Minigame Build, y pedir al usuario que inicie sesión escaneando un código QR [实测].

Criterios de finalización:

• El archivo de progreso contiene el AppID.
• En la página "Paquete de mejora de producción", "Adaptación Rápida" muestra "Habilitado".
• En la configuración básica, el nombre y la categoría de servicio están completos.
• La herramienta de desarrollador ha iniciado sesión.

P2 Compilación y exportación

1. Instalar el módulo WebGL, luego ejecutar scripts/fetch_wxsdk.sh <proyecto> para incrustar el SDK en Packages/ y aplicar parches [实测].
2. Copiar scripts/ShipWeChatBuild.cs en <proyecto>/Assets/Editor/. Luego, escribir <proyecto>/publish/wechat/build.json según templates/build.json [实测].
3. Usar ../ship-my-game/scripts/make_cjk_font.py para generar el subconjunto de fuentes CJK, y completar cjkFont y latinFonts en build.json [实测].
4. Modificar el código según "Requisitos técnicos" [实测].
5. Exportar: ejecutar ../ship-my-game/scripts/unity_build.sh <proyecto> WebGL ShipWeChatBuild.Export wechat [实测].
6. En la herramienta de desarrollador, "Proyecto → Importar proyecto", seleccionar <proyecto>/Builds/wechat/minigame, hacer clic en "Confiar y ejecutar", y recorrer el flujo principal en el simulador [实测].
7. Usar scripts/wx_cold_start.py en el simulador para reproducir la primera apertura: borrar caché, retrasar la llegada del paquete de recursos 12 segundos, compilar, ver el resultado y restaurar. El revisor abre así la primera vez, no se ve en tu propio teléfono. Pasos en build.md [实测].

Criterios de finalización:

• En los registros aparece [Ship] wechat export=SUCCEED. Para proyectos Unity 6, también [Ship] framework patched y una línea que comienza con [Ship] B7.
• Reproducción de la primera apertura: el simulador muestra la pantalla de carga y luego la pantalla principal, wx_cold_start.py log muestra OK, y finalmente release.
• El simulador puede entrar en la pantalla principal, los toques responden, y la consola no muestra errores rojos (excepto registros ignorables).
• El tamaño del paquete mostrado en el panel de vista previa está dentro del límite.

Ver build.md para detalles y tabla de parches.

P3 Verificación en dispositivo real

1. Cambiar el panel de vista previa a "Vista previa por código QR". No usar "Vista previa automática" ni "Depuración en dispositivo real" [实测].
2. Generar el código de vista previa, enviar la captura de pantalla al usuario, o dejar que el usuario escanee el código en la herramienta de desarrollador. El código caduca aprox. en 25 minutos [实测].
3. Revisar con el usuario cada elemento de la lista de verificación en dispositivo real de build.md: sonido, chino, toque, guardado persistente después de salir y volver a entrar, que la muesca y el botón de cápsula no obstruyan la interfaz, que no haya entradas que no se abran, y que la pantalla principal muestre el nombre chino.
4. También hacer la primera apertura en el móvil: primero eliminar el minijuego de "Usados recientemente" en WeChat, luego escanear el código. No se ha verificado si eliminar limpia la caché de recursos; la conclusión se basa en la reproducción del simulador en la etapa P2. Si aparece una pantalla negra, detenerse y consultar troubleshooting.md; no confiar en "volver a entrar en el mini programa" para superarlo: el revisor solo abre una vez, y el primer envío fue rechazado por esto [实测].

Criterios de finalización: El usuario confirma que todos los elementos de la lista pasan en al menos un teléfono. Si hay dispositivos Android e iOS, probar en ambos.

P4 Campos obligatorios del panel, calificaciones y certificación (puede hacerse en paralelo con P2 y P3)

1. Indicación de edad adecuada: "Configuración de cuenta → Configuración básica → Indicación de edad adecuada → Configurar". Completar según console.md, el usuario confirma y hace clic en "Enviar para revisión" (verificado en el panel).
2. Guía de protección de privacidad del usuario: "Declaración de contenido del servicio → Guía de protección de privacidad del usuario → Mejorar". Para juegos sin conexión, seleccionar "No se procesa ninguna información del usuario de ninguna manera", el usuario confirma y hace clic en "Confirmar el contenido anterior" (verificado en el panel).
3. Envío de calificaciones: Seleccionar "Caso 2: El minijuego no necesita ni necesitará pagos virtuales", el usuario firma los materiales [实测]. Ver filing.md.
4. Certificación de WeChat: Realizada por el usuario [实测]. Ver onboarding.md.
5. Verificación de nombre real del Departamento Central de Propaganda: Si no se habilita el pago virtual, no es necesario hacer nada; el texto de la página dice "No se requiere operación del desarrollador" (verificado en el panel).

Criterios de finalización:

• La indicación de edad adecuada muestra "Enviada" o "Aprobada".
• La guía de protección de privacidad ya no muestra "No actualizada".
• La calificación muestra "En revisión" o "Aprobada".
• La certificación de WeChat está completada, o pagada y en revisión.

P5 Registro del minijuego

1. Confirmar cuatro cosas:
   • El nombre está finalizado.
   • La calificación se ha enviado.
   • La indicación de edad adecuada se ha enviado.
   • Ya existe una versión de vista previa: la pantalla principal muestra el nombre chino y la ventana emergente de "Consejos de optimización" está cerrada.
2. Abrir el formulario de registro, entrada en filing.md. El paso 1 lo hace el usuario: seleccionar el tipo de juego y el tipo de red, luego escanear un código QR con el móvil para firmar tres documentos [实测].
3. El texto del paso 2 lo rellenas tú. Primero verifica el código, luego escribe la escena, la jugabilidad y el sistema según templates/filing-content.md [实测].
4. Dar al usuario la lista de capturas de pantalla, pídele que las tome en el WeChat móvil. Las renombras por categoría, usas el método de transferencia local para subir una categoría a la vez, después de subir haces clic en "Guardar", actualizas y verificas [实测].
5. Pasar por la compuerta de envío: enumerar al usuario lo que se va a enviar, cuando el usuario diga "Enviar", hacer clic en "Siguiente → Vista previa de la información → Enviar", o pedirle al usuario que lo haga él mismo [实测].

Criterios de finalización: En la página "Guía de proceso de registro y publicación del minijuego", el registro del minijuego muestra "En revisión por la plataforma". En el archivo de progreso, "En espera" indica el tiempo estimado: revisión inicial de la plataforma 12 días hábiles, revisión de la autoridad 1020 días hábiles.

P6 Registro del mini programa (ICP)

Basado en: Registro del mini programa, Guía de operaciones de registro, Ejemplos de materiales. Llenar el formulario y enviar ya ha sido probado; después de la revisión inicial, seguir lo oficial.

1. Esperar a que el registro del minijuego muestre "Aprobado por la autoridad" y que la certificación de WeChat esté completada. En las pruebas, la página de guía requería que ambas estuvieran completas para que el botón "Iniciar registro" estuviera disponible [实测].
2. Antes de abrir el formulario, explicar al usuario de una vez lo que necesita preparar: fotos de ambas caras del DNI, dirección de contacto detallada (hasta el número de puerta), dos números de teléfono móvil propios y un correo, requisitos de fondo para la verificación facial; si la provincia de registro es Guangdong o Xinjiang, escribir una declaración jurada a mano. Y acordar que el "Envío" debe esperar tu verificación. En las pruebas, el usuario llenó y envió directamente [实测]. Lista en filing.md.
3. Desde la página de guía, hacer clic en "Iniciar registro", se abre una nueva pestaña "Verificar tipo de registro". No es necesario seleccionar Caso 1 / Caso 2 ni el tipo de registro [实测].
   • Usuario: seleccionar región, subir DNI, hacer clic en "Verificar"; llenar dirección, teléfono y correo; escanear código QR para verificación facial; firmar declaración jurada (Guangdong, Xinjiang).
   • Tú: redactar la "Nota (obligatorio)" para que el usuario la confirme (oficialmente no hay requisito, no confirmado); leer la página "Vista previa de materiales" para verificar.
4. En la página "Vista previa de materiales", pasar por la compuerta de envío: enumerar al usuario el contenido del servicio, las notas y los materiales subidos; pedirle que verifique la dirección y la información del documento; el usuario marca la casilla de aceptación de términos en la parte inferior; cuando el usuario diga "Enviar", hacer clic [实测].
5. Después de la aprobación inicial de la plataforma, recordar al usuario: recibirá un SMS del 12381, debe completar la verificación en el sitio web de registro del MIIT dentro de 24 horas; si se pasa el tiempo, se rechazará [官方].

Criterios de finalización: El panel muestra que el número de registro ha sido emitido; o la página principal "Registro y certificación" muestra que el registro del mini programa está en revisión (probado como "En revisión por la plataforma"), y el archivo de progreso indica la hora de envío, la etapa de revisión actual y el tiempo estimado.

P7 Subir la versión de desarrollo y la versión de prueba [实测]

Basado en: Trabajo colaborativo y lanzamiento, miniprogram-ci.

1. Confirmar que la exportación es la versión a enviar: los ID de los bloques de anuncios pueden estar vacíos por ahora, el nombre en la pantalla principal es correcto y la ventana emergente de "Consejos de optimización" está cerrada.
2. Subir, elegir uno de los dos métodos:
   • "Subir" de la herramienta de desarrollador, llenar número de versión y nota del proyecto [实测];
   • Línea de comandos scripts/wx_ci.js upload, requiere clave de subida y lista blanca de IP, ver automation.md (no probado).
3. Abrir "Gestión de versiones → Versión de desarrollo", confirmar que se ve esta versión, luego desde la flecha desplegable junto a "Enviar para revisión" seleccionarla como "Versión de prueba", pedir al usuario que escanee el código de la versión de prueba para hacer una última verificación [实测]. Detalles en review.md.

Criterios de finalización: En la lista de versiones de desarrollo aparece este número de versión, y la versión de prueba se puede abrir en el teléfono.

P8 Compuerta de envío [实测]

Basado en: Revisión de versiones.

1. Verificar las condiciones previas:
   • La indicación de edad adecuada y la guía de protección de privacidad están completas.
   • La versión de desarrollo se ha subido.
   • El nombre mostrado en el juego coincide con el nombre en el panel.
2. En "Gestión de versiones → Versión de desarrollo", hacer clic en "Enviar para revisión", llenar el formulario según review.md. El formulario está en un iframe entre dominios en una nueva pestaña; solo se puede tomar capturas de pantalla y operar por coordenadas.
3. Pasar por la compuerta de envío de la entrada principal: enumerar al usuario el canal, número de versión, tamaño del paquete, notas de la versión, declaración de privacidad y publicidad, y tiempo estimado de revisión (oficialmente 1 día natural, probado 1~3 horas para obtener resultado), esperar a que el usuario diga "Enviar".
4. Hacer clic en "Enviar" en el formulario, en el aviso de cumplimiento de privacidad hacer clic en "Continuar enviando", luego leer "Gestión de versiones" y confirmar que "Versión en revisión" muestra "En revisión".

Criterios de finalización: "Versión en revisión" muestra "En revisión". El archivo de progreso indica la hora de envío, el tiempo estimado y dónde ver los resultados (página "Gestión de versiones", mensajes internos).

Periodo de espera y después del lanzamiento

Duración de cada elemento en espera (escribir en el archivo de progreso "En espera")

• Calificación: probado aprobado; la página dice aproximadamente 1 día hábil, oficialmente 1~3 días naturales.
• Registro del minijuego: revisión inicial de la plataforma 12 días hábiles, autoridad 1020 días hábiles. Probado: enviado 10-24, entró en "Revisión de la autoridad" 10-31, aprobado al revisar 11-07.
• Registro del mini programa: oficialmente, Caso 2 aproximadamente 1030 días hábiles; el panel también muestra 310 (página de guía) y 222 (ventana emergente "Debe completar el registro" en la página de gestión de versiones), dar la expectativa más larga. Revisión inicial de la plataforma 12 días hábiles, si se rechaza y se reenvía, 7 días hábiles.
• Revisión de la versión: oficialmente aproximadamente 1 día natural; probado dos veces, ambas con resultado el mismo día, aproximadamente 3 horas (rechazo) y aproximadamente 1 hora (aprobación).

Cosas que no se deben hacer durante la espera

• No cambiar el nombre ni transferir el sujeto del registro: ambos registros se invalidarán y habrá que empezar de nuevo.
• No hacer clic en "El plugin tiene una actualización" en la herramienta de desarrollador: la versión del plugin sigue la del SDK [实测].

Cosas que se pueden hacer durante la espera: Integrar el código de anuncios (dejar el ID vacío), tomar capturas de pantalla.

Publicación: Después de la aprobación, en "Gestión de versiones → Versión en revisión", hacer clic en "Enviar para publicación", seleccionar publicación completa o gradual, luego el administrador confirma escaneando un código QR. Preguntar al usuario antes de publicar [实测]. Los juegos sin conexión no necesitan esperar el número de registro del mini programa; los juegos en línea, según lo oficial, deben obtenerlo primero. Ver review.md.

Después del lanzamiento

• Materiales de marketing: En "Gestión de materiales de marketing", llenar la descripción del juego, la portada del material general, las imágenes promocionales verticales y horizontales, el texto promocional y el video promocional. Determinan cómo se muestra en los resultados de búsqueda y en la página de descubrimiento. El texto y las imágenes solo se pueden modificar 3 veces al mes, los videos promocionales 10 conjuntos por semana. Primero muestra las imágenes de muestra, los videos de muestra y el texto al usuario, y una vez que esté de acuerdo, envíalos. Ver listing.md [实测].
  • Cuando el aviso en la parte superior de la página indique que falta "Video promocional - Pantalla real", grabar la pantalla real del juego como se indica en listing.md en "Hacer video promocional": juego vertical 1080×1920, 20~30 segundos, sin texto ni marcos en la imagen.
• '流量主' (anuncios): Se puede habilitar solo cuando los visitantes únicos acumulados superen los 100 (o cumplan las condiciones del círculo de juego). El mismo día de la habilitación, completar los datos financieros, luego crear bloques de anuncios, llenar los ID en el juego y lanzar otra versión. Ver capabilities.md, pagos en payouts.md.
• Fallo al iniciar: Después del lanzamiento, en el panel, en "Registros en tiempo real", ver los registros de la sesión que falló al iniciar y anotarlos en el archivo de progreso.

Si es rechazado o estancado: Consultar review.md y troubleshooting.md.