Instalación

Desde cero

Proporcionamos código de ejemplo que muestra cómo integrar el SDK en su aplicación Android.

SORI Example Android Kotlin

Consulte la aplicación de ejemplo y pruebe su funcionamiento.

Integración en un proyecto existente

1. Añada el repositorio de Maven al archivo settings.gradle raíz de su proyecto:

   settings.gradle

   // ... omit ...
   dependencyResolutionManagement {
       repositories {
           maven { url "https://maven.iplateia.com/sorisdk/" } 
       }
   }

   settings.gradle.kts

   // ... omit ...
   dependencyResolutionManagement {
       repositories {
           maven("https://maven.iplateia.com/sorisdk/") 
       }
   }

2. A continuación, añada lo siguiente al archivo app/build.gradle de su aplicación:

   app/build.gradle

    dependencies {
        implementation 'com.acme.corp:package1:2.10.1'
        implementation 'com.awsome.corp:package2:3.14.159'
        implementation 'com.iplateia:sorisdk:5.0.0'
    }

   app/build.gradle.kts

    dependencies {
        implementation("com.acme.corp:package1:2.10.1")
        implementation("com.awsome.corp:package2:3.14.159")
        implementation("com.iplateia:sorisdk:5.0.0") 
    }

   Versión

   Utilice el paquete 5.0.0 más reciente para las integraciones nuevas. Las aplicaciones existentes que utilizan 4.3.x pueden actualizar sin modificar el flujo básico de inicio y detención.

   ¡Eso es todo! Ya puede utilizar SORI SDK en su proyecto Android.

Configuración de AndroidManifest.xml

SORI Android SDK requiere que se declaren determinados permisos y servicios en el archivo AndroidManifest.xml de su aplicación.

Para grabar audio se necesita el permiso android.permission.RECORD_AUDIO. Este permiso permite grabar audio desde el micrófono.

Para gestionar los materiales de audio de destino y sincronizarlos con el dispositivo del usuario se necesita el permiso android.permission.INTERNET.

Para el servicio en primer plano se necesita el permiso android.permission.FOREGROUND_SERVICE. Desde Android 8.0 (API level 26), todos los servicios que realizan operaciones de larga duración, como el reconocimiento de audio, deben iniciarse como servicios en primer plano. Este permiso permite iniciar un servicio en primer plano. Además, a partir de API level 33 se necesita el permiso android.permission.POST_NOTIFICATIONS para mostrar notificaciones de servicios en primer plano.

Añada lo siguiente al archivo AndroidManifest.xml de su aplicación:

<manifest ...>
    <!-- required android permissions -->
    <uses-permission android:name="android.permission.INTERNET" /> 
    <uses-permission android:name="android.permission.RECORD_AUDIO" /> 
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" /> 
    <!-- Only required after Android 33 tiramisu -->
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> 

Registre los servicios de reconocimiento de audio en el archivo AndroidManifest.xml de su aplicación:

    <application ...>
        <!-- ... -->
        <service
            android:name="com.iplateia.sorisdk.SORIAudioRecognitionService"
            android:exported="false"
            android:foregroundServiceType="microphone" />
    </application>
</manifest>

Ya está todo preparado para utilizar el SDK. El siguiente paso es la Implementación.

Configuración de R8 y ProGuard

Cuando se instala el SDK desde el repositorio de Maven, las reglas de consumidor necesarias para R8 y ProGuard se incluyen en el paquete del SDK. La mayoría de las aplicaciones no necesitan añadir reglas keep adicionales.

Si su compilación utiliza un flujo de empaquetado personalizado en lugar del artefacto de Maven, asegúrese de conservar las reglas de consumidor del SDK.