Interface NowChatSdkCallbacks : Android

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 : autorise l’ouverture du sélecteur de fichiers.
    isGalleryCollectionBloqué Booléen Marqueur indiquant si l’application hôte doit empêcher Now Chat d’ouvrir la galerie de photos.
    Valeurs valides :
    • true : empêche la galerie de photos de s’ouvrir.
    • false : autorise l’ouverture de la galerie de photos.
    isLocationCollectionBlocked 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 Now Chat d’accéder à la caméra.
    Valeurs valides :
    • true : empêche l’accès à l’appareil photo.
    • false : n’empêche pas l’accès à la caméra.

    NowChatSdkCallbacks - loadUri(uri : Uri, context : Context)

    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
    Néant

    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 vous quittez Now Chat.

    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é sur l’instance.
    • SessionInitializationError : impossible d’initialiser la session avec l’instance.
    • UserExit : l’utilisateur a quitté à l’aide du bouton haut ou retour
    • Inconnu : toute raison inconnue.
    Tableau 5. Renvoie
    Type Description
    Néant

    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 lorsque les données de l’interface utilisateur NowChat sont chargées. 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 de l’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
      }
    }