NowChatOptions – Android

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer
  • Mit der Klasse NowChatOptions können Sie Optionen in einer Chatsitzung konfigurieren, z. B. das Anzeigen einer Eingabeaufforderung vor dem Schließen eines Chatfensters, das Deaktivieren von Funktionen während der Verwendung des Chats und das Erzwingen einer neuen Chatunterhaltung, wenn der Chatservice gestartet wird.

    NowChatOptions: NowChatOptions(closePrompt: ClosePrompt?,disabledFeatures: Liste<Feature> ?,forceNewConversation: Boolesch?)

    Konfiguriert Optionen für die aktuelle Chatsitzung. Mit dieser Methode können Sie eine Eingabeaufforderung anzeigen, bevor Sie ein Chatfenster schließen, Funktionen während der Verwendung des Chats deaktivieren und eine neue Chatunterhaltung erzwingen, wenn der Chatservice gestartet wird.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    closePrompt ClosePrompt- Objekt Aufforderung zum Anzeigen vor dem Schließen des zugehörigen Chatfensters.

    Wenn keine Aufforderung zum Schließen angezeigt werden soll, übergeben Sie NULL.

    disableFeatures Liste<NowChatOptions.Feature> Liste der Chatfunktionen, die innerhalb der aktuellen Chatsitzung deaktiviert werden sollen
    Gültiger Wert:
    • START_NEW_CONVERSATION: Schaltfläche „ StartNew Conversation “ in einem Chatfenster ausblenden/deaktivieren

    Die verfügbaren Chatfunktionen sind in der Aufzählungsklasse NowChatOptions.Feature definiert.

    Wenn Sie keine Funktionen deaktivieren möchten, übergeben Sie NULL.

    Erzwingen Sie eine neue Konversation Boolean Kennzeichnung, die angibt, ob eine neue Chatunterhaltung erzwungen werden soll, wenn die Chatsitzung beginnt. Alle aktuellen Konversationen werden geschlossen.
    Gültige Werte:
    • true: Neue Chatunterhaltung starten; Ein neues Chatfenster wird geöffnet.
    • „falsch“: Keine neue Chatunterhaltung starten. lädt den Inhalt der vorherigen Chatunterhaltung.

    Standardwert: false

    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    chatOptionen Gibt ein chatOptions-Objekt zurück, das Sie in der Methode NowChatService – start(activity: Activity, topicColors: NowChatTheme = object: NowChatTheme{}, contextData: Map<String, Any> = mapOf(), chatOptions: NowChatOptions? = null) übergeben können.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    suspend fun launchChat() { 
      val chatService = getNowChatService() 
      val chatTheme = object : NowChatTheme { 
        override val brand: NowUIAdaptiveColor 
        get() = NowUIAdaptiveColor(Color.BLUE) 
     
        override val textPrimary: NowUIAdaptiveColor 
        get() = NowUIAdaptiveColor(Color.BLACK) 
     
        // Override remaining theme colors 
     
      } 
      val contextData = mapOf("sys_id" to "123456789", "table" to "wm_task") 
     
      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 
      )
     
       chatService?.start(activity, chatTheme, contextData, chatOptions) 
    } 

    NowChatOptions – ClosePrompt(header: Zeichenfolge, Nachricht: Zeichenfolge, akzeptieren Schaltflächentitel: Zeichenfolge, declinButtonTitle: Zeichenfolge)

    Erstellt ein ClosePrompt-Objekt und gibt es basierend auf den übergebenen Parametern zurück. Anschließend übergeben Sie dieses Objekt an die NowChatOptions()- Methode, um die Optionen zum Schließen der Aufforderung in einer Chatsitzung zu konfigurieren.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    header Zeichenfolge Text, der im Header der Eingabeaufforderung angezeigt werden soll.

    Wenn Sie keinen Eingabeaufforderungsheader anzeigen möchten, übergeben Sie NULL.

    message Zeichenfolge Text, der als Haupttext der Eingabeaufforderung angezeigt werden soll.
    akzeptierenSchaltflächentitel Zeichenfolge Text, der auf der primären Schaltfläche der Eingabeaufforderung zum Schließen des Chat-Fensters angezeigt werden soll.
    AblehnenSchaltflächeTitel Zeichenfolge Text, der auf der sekundären Schaltfläche der Eingabeaufforderung angezeigt werden soll, die die Eingabeaufforderung schließt.

    Wenn Sie keine sekundäre Schaltfläche anzeigen möchten, übergeben Sie NULL.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    suspend fun launchChat() { 
      val chatService = getNowChatService() 
      val chatTheme = object : NowChatTheme { 
        override val brand: NowUIAdaptiveColor 
        get() = NowUIAdaptiveColor(Color.BLUE) 
     
        override val textPrimary: NowUIAdaptiveColor 
        get() = NowUIAdaptiveColor(Color.BLACK) 
     
        // Override remaining theme colors 
     
      } 
      val contextData = mapOf("sys_id" to "123456789", "table" to "wm_task") 
     
      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 
      )
     
       chatService?.start(activity, chatTheme, contextData, chatOptions) 
    }