Interface NowChatSdkCallbacks : Android

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • L’interface NowChatSdkCallbacks fournit des fonctions qui activent les rappels pour les applications hôtes afin de configurer ou de gérer les actions à partir du NowChatSDK.

    Tableau 1. Propriétés
    Nom Type Description
    isFileCollectionBlocked Booléen Marqueur indiquant si l’application hôte doit empêcher NowChat d’ouvrir le sélecteur de fichier.
    Valeurs valides :
    • true : empêche l’ouverture du sélecteur de fichiers.
    • false : autoriser l’ouverture du sélecteur de fichiers.
    isGalleryCollectionBlocked Booléen Marqueur indiquant si l’application hôte doit empêcher NowChat d’ouvrir la galerie de photos.
    Valeurs valides :
    • true : empêche la galerie de photos de s’ouvrir.
    • false : autoriser l’ouverture de la galerie de photos.
    isLocationCollectionBlocked (en anglais seulement) Booléen Marqueur indiquant si l’application hôte doit empêcher NowChat d’accéder au positionnement de géolocalisation.
    Valeurs valides :
    • true : empêche l’accès au positionnement de géolocalisation.
    • false : n’empêche pas l’accès au positionnement de géolocalisation.
    isPhotoCollection bloqué Booléen Marqueur indiquant si l’application hôte doit empêcher NowChat d’accéder à la caméra.
    Valeurs valides :
    • true : empêche l’accès à l’appareil photo.
    • faux : n’empêche pas l’accès à l’appareil photo.

    NowChatSdkCallbacks : loadUri(uri : Uri, contexte : Contexte)

    Gère l’URI spécifié, par exemple pour l’ouvrir dans une vue Web, un onglet personnalisé ou un navigateur externe.

    Tableau 2. Paramètres
    Nom Type Description
    uri URI URI à ouvrir.
    contexte Contexte Contexte d’application.
    Tableau 3. Renvoie
    Type Description
    Aucun

    L’exemple de code suivant montre comment appeler cette fonction.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun loadUri(uri: Uri, context: Context) {
    
        // Open the uri in a webview
        val webview = WebView(context)
        webview.loadUrl(uri.toString())
      }
    
      // Override other methods
    }

    NowChatSdkCallbacks : onExit(exitCode : NowChatExitCode)

    Définit le code de résultat à renvoyer lorsque Now Chat est quitté.

    Ce rappel est appelé lorsque cette messagerie instantanée en plein écran est fermée et que l’utilisateur est renvoyé à l’application hôte.

    Tableau 4. Paramètres
    Nom Type Description
    exitCode NowChatExitCode (en anglais seulement) Motif pour quitter la messagerie instantanée Now.
    Valeurs valides :
    • ChatPluginNotInstalledError : le module d’extension de messagerie instantanée n’est pas installé dans l’instance.
    • SessionInitializationError : impossible d’initialiser la session avec l’instance.
    • UserExit : l’utilisateur a quitté à l’aide du bouton Haut ou Retour
    • Inconnu : tout motif inconnu.
    Tableau 5. Renvoie
    Type Description
    Aucun

    L’exemple de code suivant montre comment appeler cette fonction.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
    
      override fun onExit(exitCode: NowChatExitCode) {
        when (exitCode) {
          NowChatExitCode.UserExit -> Log.i("NowChat", "User exited using the up button or back button")
          NowChatExitCode.SessionInitializationError -> Log.i("NowChat", "Unable to initialize session with instance")
          NowChatExitCode.ChatPluginNotInstalledError -> Log.i("NowChat", " Chat plugin not installed on instance.")
          NowChatExitCode.Unknown -> Log.i("NowChat", "User exited for Unknown reason")
        }
      }
    
      // Override other methods
    }

    NowChatSdkCallbacks : provideProgressView(contexte : contexte)

    Renvoie la vue à afficher lors du chargement des données de l’interface utilisateur NowChat ; Il s’agit généralement d’une barre de progression indéterminée configurée.

    Tableau 6. Paramètres
    Nom Type Description
    contexte Contexte Contexte d’application à utiliser pour créer la vue.
    Tableau 7. Renvoie
    Type Description
    Afficher Vue que le service NowChat utilise lors du chargement.

    L’exemple de code suivant montre comment appeler cette fonction.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun provideProgressView(context: Context): View? {
        return ProgressBar(context).apply {
          indeterminateTintList = ColorStateList.valueOf(
            MaterialColors.getColor(
              context,
              android.R.attr.colorPrimary,
              Color.BLACK)
          )
        }
    
        // Override other methods
      }
    }