Guía de integración del miniprograma

Conectar MeowID a Zhongdamaopu

Registra las fotos aprobadas de tu catálogo de gatos del campus en MeowID para buscar gatos similares y abrir sus fichas existentes. Zhongdamaopu conserva los datos; MeowID proporciona el registro de imágenes y la búsqueda de identidades.

7 capturas de la interfaz realÚltima revisión
  1. 01Crear proyecto y clave
  2. 02Configurar el servicio
  3. 03Sincronizar fotos y probar el reconocimiento

01 · Antes de empezar

Esta guía parte de un Zhongdamaopu o catálogo derivado que ya incluye los ajustes del servicio de reconocimiento. Explica la configuración de MeowID y el uso del miniprograma.

  • Una cuenta de MeowID con permiso para crear proyectos y claves API.
  • Una cuenta de administrador de nivel 99 en el miniprograma para configurar y sincronizar.
  • Fichas de gatos y fotos aprobadas para registrar y comprobar los resultados.

Los usuarios podrán buscar gatos similares y abrir sus fichas desde el mismo miniprograma. Empieza con pocos gatos y fotos claras de un solo gato antes de ampliar la sincronización.

02 · Crear un proyecto de MeowID

  1. Accede a la consola de MeowID y crea un proyecto para el catálogo.
  2. Copia el ID del proyecto de sus detalles; lo introducirás en «项目编号» del miniprograma.
  3. Consulta el saldo y las tarifas, y recarga si hace falta. El registro y el reconocimiento pueden generar cargos.

Mantén el mismo proyecto para el catálogo. La sincronización crea un gato remoto para cada ficha local; no es necesario crearlos manualmente uno por uno.

Crea un proyecto en MeowID con un nombre que identifique el catálogo del campus.
Crea un proyecto en MeowID con un nombre que identifique el catálogo del campus.Abrir imagen a tamaño completo ↗

03 · Crear una clave para sincronizar y reconocer

Abre API Keys, selecciona el mismo proyecto y crea una clave con acceso completo o con estos cuatro permisos personalizados.

PermisoUso
recognition:writeBuscar la identidad del gato
cats:readComprobar la conexión y leer gatos e imágenes
cats:writeCrear fichas y registrar fotos aprobadas
tasks:readConsultar tareas de registro y resultados

Una clave solo de reconocimiento no permite completar la sincronización. Guarda la clave completa cuando se muestre, normalmente una sola vez, e introdúcela en la configuración siguiente. No la publiques ni la incluyas en capturas.

Crea la clave en el proyecto correcto y comprueba los cuatro permisos de reconocimiento, lectura y escritura de gatos y lectura de tareas.
Crea la clave en el proyecto correcto y comprueba los cuatro permisos de reconocimiento, lectura y escritura de gatos y lectura de tareas.Abrir imagen a tamaño completo ↗

04 · Activar y configurar MeowID

  1. Accede como administrador de nivel 99 y abre 关于 → 小程序配置 → 识猫服务 (Acerca de → Configuración del miniprograma → Reconocimiento de gatos). Los administradores de nivel inferior no ven esta opción.
  2. Selecciona MeowID como modo y guárdalo.
  3. Introduce el ID del proyecto, la clave API y la URL base de la API. El valor predeterminado es https://platform.meowid.net; https://meowid.net/developers es documentación, no un endpoint.
  4. Mantén inicialmente 5 candidatos, guarda y comprueba la conexión.

El ID y la clave deben pertenecer al mismo proyecto. La clave guardada no se vuelve a mostrar: dejar el campo vacío conserva su valor, no significa que falte.

Las capturas del miniprograma conservan la interfaz real en chino; nombres y cantidades pueden variar. El número de candidatos limita los resultados de búsqueda, no las fotos por gato.

Entrada de reconocimiento para administradores de nivel 99, en Acerca de → Configuración del miniprograma. La interfaz está en chino.
Entrada de reconocimiento para administradores de nivel 99, en Acerca de → Configuración del miniprograma. La interfaz está en chino.Abrir imagen a tamaño completo ↗
Guarda primero el modo MeowID y después el proyecto y la clave. Los secretos guardados no se muestran.
Guarda primero el modo MeowID y después el proyecto y la clave. Los secretos guardados no se muestran.Abrir imagen a tamaño completo ↗

05 · Sincronizar fichas y fotos aprobadas

Ambos modos sincronizan fichas, omiten las fotos con recibo de aceptación y usan únicamente fotos aprobadas; no necesitan estar marcadas como destacadas.

Botón de la interfazComportamiento
按上限同步 · Sincronizar hasta el límiteGuarda antes el límite por gato: mínimo y valor predeterminado 5. Con tres envíos previos y límite cinco, solo se añaden dos.
全量 / 增量同步 · Sincronización completa / incrementalProcesa todas las fotos aprobadas sin límite por gato, incluidas las aplazadas por el límite. Sigue omitiendo recibos existentes.
刷新状态 · Actualizar estadoConsulta el estado y concilia tareas; no inicia un nuevo lote de imágenes.

Empieza con límite para controlar el consumo histórico. Si solo hay tres fotos, se suben tres, sin duplicarlas para llegar a cinco. Sin fotos se puede sincronizar la ficha. Reducir el límite no elimina imágenes remotas.

Mantén abierta la página. Salir detiene los nuevos lotes, aunque los ya enviados pueden continuar. Selecciona el mismo modo para reanudar. Conserva los registros y no fuerces reenvíos solo por diferencias entre totales locales y remotos.

Panel de sincronización: guarda el límite por gato, elige el modo y consulta los recuentos sincronizados y pendientes.
Panel de sincronización: guarda el límite por gato, elige el modo y consulta los recuentos sincronizados y pendientes.Abrir imagen a tamaño completo ↗

06 · Revisar recuentos y tareas de registro

Los gatos sincronizados y pendientes cuentan fichas locales vinculadas al servicio remoto; las imágenes subidas y pendientes se basan en registros de aceptación de fotos aprobadas. Procesadas más pendientes equivale al total.

Subida no significa registro completado. Aún se necesitan recorte y extracción de características. Revisa la cola del proyecto:

  • queued / running: aceptada, en espera o en proceso.
  • completed: registro terminado; usa las imágenes disponibles para probar el reconocimiento.
  • waiting_user: confirma el gato objetivo en la consola.
  • failed: consulta el error; una tarea fallida con recibo no se reenvía repetidamente como foto nueva.

Las pendientes pueden estar limitadas, fallidas o sin resultado confirmado: no todas deben reenviarse. Los vínculos locales también pueden diferir del total remoto, que incluye altas manuales o registros antiguos.

Comprueba el registro en la cola del proyecto. La aceptación y la finalización son etapas distintas.
Comprueba el registro en la cola del proyecto. La aceptación y la finalización son etapas distintas.Abrir imagen a tamaño completo ↗

07 · Probar el reconocimiento en el miniprograma

  1. Elige un gato vinculado con imágenes registradas disponibles y una foto clara de un solo gato, preferiblemente distinta para la prueba.
  2. En el catálogo, pulsa 识别 (Reconocer) junto a la búsqueda y toma una foto o elígela del álbum.
  3. Abre una ficha desde los candidatos y verifica nombre, imágenes y enlace.

El miniprograma muestra las fichas locales vinculadas a los candidatos de MeowID. Compara nombres, fotos y rasgos distintivos.

La similitud ordena candidatos; no es un porcentaje de exactitud. No detectar gatos, no confirmar la identidad y fallar la solicitud son resultados distintos. Cambiar de gato en una foto con varios vuelve a solicitar reconocimiento y puede generar consumo. Empieza con un solo gato.

Entrada de reconocimiento junto al buscador. La siguiente pantalla permite usar cámara o álbum.
Entrada de reconocimiento junto al buscador. La siguiente pantalla permite usar cámara o álbum.Abrir imagen a tamaño completo ↗

08 · Nuevas aprobaciones y mantenimiento

Con MeowID activo, aprobar una foto nueva intenta registrarla directamente. No se aplica el límite por gato de los lotes manuales. Las revisiones pueden guardarse durante otra sincronización o una subida incompleta; reanuda después para enviar las restantes.

  • Conserva los registros y continúa con el botón adecuado, sin recrear fichas.
  • Comprueba envíos inciertos en la cola antes de actuar; no los repitas inmediatamente.
  • No añadas la misma foto como registros separados: pueden enviarse por separado.
  • Antes de cambiar proyecto o clave, comprueba a qué proyecto pertenecen. Mantén un mismo proyecto para el catálogo.

09 · Solución de problemas

SíntomaQué comprobar
No aparece el servicioUsa una cuenta de nivel 99 y busca en 关于 → 小程序配置.
No comienza la sincronización limitadaGuarda un entero de al menos cinco. Reintenta más tarde si falla el estado y conserva los registros.
401 / 403Validez de clave, mismo proyecto, los cuatro permisos y lista de IP permitidas.
Hay conexión, pero no termina el registroConexión y registro son distintos. Revisa permisos, fotos, errores y progreso en la consola.
Difieren los recuentos de gatosVínculos locales y total remoto usan reglas distintas; el total no basta para detectar duplicados o ausencias.
Quedan imágenes pendientesRevisa límites, esperas de reintento, fallos y confirmaciones manuales. Usa el modo completo / incremental para todas las fotos aptas.
Se agota el tiempo de esperaRevisa la red, reintenta o consulta la cola. Conserva los registros y contacta con mantenimiento si persiste.
Envío sin confirmarConcilia primero con los resultados de MeowID. Los envíos inciertos no se repiten automáticamente.

Consulta la referencia API y el recorrido de la consola. Al informar de un problema, incluye mensaje, ID de tarea y hora, nunca la clave API.

Sincronizar fotos y probar el reconocimiento

Abrir la consola de MeowID