Transmettre NowChatOptions pour modifier le comportement de NowChat

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture
  • Vous pouvez transmettre un paramètre facultatif NowChatOptions lors du démarrage d’une session de messagerie instantanée pour modifier certains comportements de NowChat.

    L’objet NowChatOptions contient les options suivantes :
    • closePrompt: texte d’invite qui s’affiche avant de quitter une fenêtre de messagerie instantanée. Vous définissez ce texte d’invite à l’aide des paramètres suivants :
      • header: valeur de chaîne pouvant être null qui apparaît dans l’en-tête de l’invite.
      • message: valeur de chaîne qui apparaît dans le corps principal de l’invite.
      • acceptButtonTitle: valeur de chaîne qui s’affiche sur le bouton primaire de l’invite. Ce bouton ferme la fenêtre de messagerie instantanée.
      • declineButtonTitle: valeur de chaîne qui s’affiche sur le bouton secondaire de l’invite. Ce bouton ferme l’invite sans fermer la fenêtre de messagerie instantanée.
    • disabledFeatures: liste des fonctionnalités de messagerie instantanée à désactiver. Consultez la classe d’énumération NowChatOptions.Feature pour obtenir la liste des fonctionnalités que vous pouvez désactiver.
    • forceNewConversation: valeur booléenne qui indique s’il faut forcer le démarrage d’une nouvelle conversation au démarrage de NowChat. Toutes les conversations en cours sont fermées. Par défaut : false.

    L’exemple de code suivant montre comment appeler cette méthode.

    class MainActivity : AppCompatActivity() {
      @Inject
    
      lateinit var sdkManager: SdkManager
    
      override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    
        val chatOptions = NowChatOptions(
          NowChatOptions.ClosePrompt(
            header = null,
            message = "Are you sure you want to leave?",
            acceptButtonTitle = "Yes",
            declineButtonTitle = "No"
          ),
          disabledFeatures = listOf(NowChatOptions.Feature.START_NEW_CONVERSATION),
          forceNewConversation = true
        )
    
        //Start NowChat using the activity
        lifecycleScope.launch {
          sdkManager.getNowChatService()?.start(this@MainActivity, chatOptions = chatOptions)
        }
      }
    }

    Pour en savoir plus, reportez-vous aux sections NowChatOptions : Android et NowChatService – start(activity : Activity, themeColors : NowChatTheme = object : NowChatTheme{}, contextData : Map<String, Any> = mapOf(), chatOptions : NowChatOptions ? = null).