SDK para Flutter

Con el SDK de SORI para Flutter, puede añadir a sus aplicaciones Flutter para Android, iOS y Web reconocimiento de audio con tecnología SORI, detección de campañas y gestión de enlaces de acción.

Requisitos previos

• Flutter 3.3.0 o posterior
• Una versión del SDK de Dart compatible con las restricciones del paquete
• Nivel de API de Android 24 o posterior
• iOS 13.0 o posterior
• Para Web: un contexto seguro (https:// o http://localhost), un navegador moderno compatible con Web Audio y getUserMedia(), y Node.js con npm para preparar el bridge

El paquete de Flutter encapsula los SDK nativos de SORI para Android e iOS y adapta el SDK de SORI para Web mediante un bridge de tiempo de compilación. Utilícelo si su aplicación está desarrollada con Flutter y desea disponer de una única API de Dart para iniciar el reconocimiento, recibir eventos de campaña, actualizar la base de datos de reconocimiento cuando sea compatible e informar de las URL de acción gestionadas.

WARNING

app_id y secret_key autentican las aplicaciones móviles ante el servidor de la API de SORI. No incluya valores reales en commits de repositorios, aplicaciones de ejemplo, incidencias, capturas de pantalla ni documentación pública. Las aplicaciones Web deben conservar el secreto de larga duración en el servidor y utilizar un endpoint de clave efímera.

Guías

• Instalación
• Implementación

Notas sobre la API

El paquete de Flutter expone eventos del ciclo de vida del reconocimiento, eventos de campaña, resultado y error, eventos opcionales de Audio Marker, actualizaciones de la base de datos y gestión explícita de URL de acción. La ubicación, el proveedor de metadatos, los búferes de audio sin procesar y la apertura automática de URL de acción no forman parte de la API pública de Flutter.

Consulte el paquete sorisdk_flutter 0.4.0 y la referencia de la API de Dart.

Aplicación de ejemplo

Ofrecemos una aplicación Flutter de ejemplo que muestra cómo integrar el SDK.

SORI Example Flutter

v0.4.0

Incluye Android 5.1.0 e iOS 5.1.0. Web SDK 0.6.10 y Web bridge 0.1.5 no cambian.

• Adopta los SDK nativos más recientes para que el material de destino pueda actualizarse sin interrumpir el reconocimiento en Android e iOS, lo que mejora la estabilidad y la continuidad durante las actualizaciones.

v0.3.8

Incluye Android 5.0.13, iOS 5.0.12, Web SDK 0.6.10 y Web bridge 0.1.5.

• Se actualizó el detector predeterminado de Audio Marker en todas las plataformas, manteniendo la activación opcional, el modo fingerprint-only predeterminado y la API de Dart existente.
• Los consumidores de Flutter Web deben actualizar la dependencia npm y el lockfile, ejecutar sori-flutter-web prepare, volver a compilar y desplegar. Los recursos ya desplegados no se actualizan automáticamente.

v0.3.7

Incluye Android 5.0.12 e iOS 5.0.11.

• Se mejoró la identificación de campañas durante el reconocimiento continuo en Android e iOS.

v0.3.6

Incluye Android 5.0.11 e iOS 5.0.10.

• Se mejoró la eficiencia de la batería durante el reconocimiento continuo en Android.
• Se mejoró la estabilidad del reconocimiento en Android, iOS y Web.

v0.3.5

Incluye Android 5.0.10 e iOS 5.0.9. El nuevo ciclo de vida del estado del marcador se aplica a estas plataformas móviles; el comportamiento de Web no cambia.

• Añade API de estado actual de Audio Marker y resultados de actividad gestionadas por el SDK.
• Enriquece los resultados de reconocimiento con atributos de marcador válidos y actualiza la misma actividad cuando su marcador se identifica más tarde.
• Conserva los marcadores de resultados históricos cuando se borra el estado actual. La conservación depende de las condiciones; no se garantizan cuatro segundos de visualización.
• Mantiene los callbacks de campaña y la integración de inicio y detención existentes; el reconocimiento de Audio Marker sigue siendo opcional.

Consulte la integración de estado y resultados de actividad y las instrucciones de instalación y actualización.