Instalación

Desde cero

El SDK de SORI para Flutter se distribuye en pub.dev como el paquete sorisdk_flutter.

Paquete sorisdk_flutter

Consulte la página del paquete para comprobar la última versión publicada y la referencia generada de la API de Dart.

También ofrecemos una aplicación Flutter de ejemplo que muestra cómo integrar el SDK.

SORI Example Flutter

Consulte la aplicación de ejemplo y pruebe cómo funciona.

Integrar el SDK en un proyecto existente

Añada el paquete desde pub.dev:

flutter pub add sorisdk_flutter:^0.4.0

También puede añadirlo a su archivo pubspec.yaml:

dependencies:
  sorisdk_flutter: ^0.4.0

A continuación, ejecute:

flutter pub get

Configuración de Android

El paquete combina los permisos de Android necesarios y la declaración del servicio de micrófono en primer plano incluidos en el manifiesto del plugin. Estos abarcan los permisos relacionados con el micrófono, la red, el servicio en primer plano y las notificaciones.

Su aplicación debe mantener el valor de minSdk de Android en 24 o superior:

android {
    defaultConfig {
        minSdk = 24
    }
}

En Android, startRecognition() solicita el permiso de micrófono en tiempo de ejecución cuando es necesario y continúa la misma solicitud de inicio una vez concedido el permiso.

Si su aplicación está destinada a Android 13 o posterior y debe mostrar con normalidad la notificación del servicio en primer plano, solicite el permiso de notificaciones desde el flujo de la aplicación antes de iniciar el reconocimiento.

Configuración de iOS

Las aplicaciones iOS deben incluir una descripción del uso del micrófono en ios/Runner/Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Audio recognition requires microphone access.</string>

Añada el modo de audio en segundo plano solo si su aplicación está diseñada para continuar el reconocimiento mientras se ejecuta en segundo plano:

<key>UIBackgroundModes</key>
<array>
    <string>audio</string>
</array>

Configuración de Web

Instale el bridge de tiempo de compilación en su aplicación Flutter. La versión 0.1.5 utiliza el rango compatible @sorisdk/web-audio ^0.6.10:

npm install --save-dev @sorisdk/flutter-web-bridge@0.1.5

Prepare el entorno de ejecución del navegador antes de cada compilación Web:

npx sori-flutter-web prepare
flutter build web

La actualización del paquete no actualiza automáticamente los recursos generados o ya desplegados. Actualice el lockfile de npm, ejecute sori-flutter-web prepare, vuelva a compilar la aplicación Flutter Web y despliegue la nueva salida.

El comando de preparación escribe los archivos JavaScript, WASM y de modelo necesarios en web/sorisdk/. Flutter copia estos archivos, que pertenecen a la aplicación, en build/web.

Flutter Web requiere un contexto seguro (https:// o http://localhost), un navegador moderno compatible con Web Audio y getUserMedia(), y un endpoint del servidor de la aplicación que devuelva una clave efímera de corta duración. Consulte Clave efímera. Nunca incluya un secret_key de larga duración en una compilación Web.

Ya puede utilizar el SDK. El siguiente paso es la implementación.