Aller au contenu principal
Version: Next

Usages avancés

Le SDK vous offre également plusieurs fonctionnalités avancées pour personnaliser l'expérience utilisateur et répondre à vos besoins spécifiques. Voici quelques-unes des fonctionnalités avancées que vous pouvez utiliser avec le SDK Surpuissant pour Android.

Détecter des mots-clés et des phrases depuis votre application​

Le SDK vous permet de réagir dans les 500ms lorsque le ou les mots-clés que vous avez définis sont détectés par l'application. Cette fonction est appelée avant même l'exécution d'une action, ce qui permet de réagir instantanément à la détection d'un mot-clé.

// Se déclenche lorsqu'un mot-clé est détecté
Surpuissant.onKeyWordDetected = { inferenceResult ->
    Log.d("MainActivity", "onKeyWordDetected: $inferenceResult")
}

De la même manière, vous pouvez réagir à la détection d'une phrase d'action dites par l'utilisateur après un mot-clé :

// Se déclenche pour une phrase suivant un mot-clé
Surpuissant.onFollowUpPhraseDetected = { phraseResult ->
    Log.d("MainActivity", "onFollowUpPhraseDetected: $phraseResult")
}

Connaitre la commande exécutée​

Le SDK peut également vous informer de la commande exécutée après la détection d'un mot-clé et d'une phrase d'action.

Surpuissant.onCommandExecuted = { commandResult ->
    Log.d("MainActivity", "onCommandExecuted: $commandResult")
}

Identifier un utilisateur unique​

Le SDK vous permet d'identifier un utilisateur unique en utilisant champs personnalisés.

Lors de l'initialisation du SDK, vous devez définir le champ customUuid dans la configuration du SDK.

Surpuissant.setup(
    Configuration(
        context = applicationContext,
        apiKey = "your-api-key",
        keywords = listOf("surpuissant"),
        customUuid = "your-user-custom-uuid",
    )
)

Vous pouvez ensuite utiliser cette valeur pour identifier un utilisateur unique en regardant le champ customUuid dans les headers de la requête envoyée à votre API (ou dans l'interface du playground pour faire vos tests).

Personnaliser les notifications​

Le SDK vous permet de personnaliser les notifications affichées par l'application. Les notifications sont nécessaires pour maintenir le service en arrière-plan et pour afficher des informations à l'utilisateur. À l'avenir, nous vous offrirons de pouvoir utiliser le SDK seulement au premier plan.

Pour personnaliser les notifications, vous devez définir les champs icon, title et content dans la configuration du SDK.

Surpuissant.setup(
    Configuration(
        context = applicationContext,
        apiKey = "your-api-key",
        keywords = listOf("surpuissant"),
        notification = SPNotification(
            icon = R.drawable.logo,
            title = "Titre de la notification",
            content = "Assistance vocale activée")
    )
)