NowChatService-Klasse – Android

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Die NowChatService -Klasse bietet Funktionen, mit denen Sie die NowChat-Aktivität starten und Fehlerkonfigurationen festlegen können.

    NowChatService – launchIntent(context:Context, themeColors:NowChatTheme):Intent

    Startet die Absicht, die zum Öffnen der NowChat-Aktivität verwendet wird. Wird normalerweise zum Erstellen eines [android.app.PendingIntent]verwendet.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    context Kontext Kontext, der zum Erstellen der Absicht verwendet wird.
    ThemaFarben NowChatTheme Optional. In der NowChat-UI zu verwendende Designfarben.

    Standard: Standardfarben

    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Zweck Absichts- und Designfarben, die zum Starten der zugeordneten NowChat-Aktivität verwendet werden.

    Dieses Beispiel zeigt, wie die launchIntent()- Methode aufgerufen und die Rückgabeaktivität verarbeitet wird.

    val intent = nowChatService.launchIntent(this) 
    val pendingIntent = PendingIntent.getActivity( 
        this, 
        REQUEST_CODE,
        intent,
        PendingIntent.FLAG_IMMUTABLE 
    ) 
    
    val notification = createNotification(title, message, pendingIntent)
    notificationManager.notify(push.notificationId, notification) 

    NowChatService – start(activity: Activity, topicColors: NowChatTheme = object : NowChatTheme{}, contextData: Map<String, Any> = mapOf())

    Startet die angegebene NowChat-Aktivität.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Aktivität Aktivität Aktivitätskontext, der zum Starten der NowChat-Aktivität und zum Empfangen des NowChatExitCode als resultCode über onActivityResult verwendetwerden soll.
    ThemaFarben NowChatTheme Optional. In der NowChat-UI zu verwendende Designfarben.

    Standard: Standardfarben

    contextData Karte<String, Any> Optional. Zusätzliche Chat-Kontextvariablen, die an die Chat-Sitzung übergeben werden.

    Weitere Informationen zu Chat-Kontextvariablen finden Sie unter Live agent chat context variables.

    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Funktion 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") 
      chatService?.start(activity, chatTheme, contextData)
    }

    NowChatService –subscribeToUnreadMessageCount(pollingInterval: Long, listener: NowChatUnreadMessagesCountListener)

    Abonniert den Listener für die Anzahl ungelesener Chatnachrichten.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Abfrageintervall Lang Häufigkeit, mit der der Webservice nach der Anzahl der ungelesenen Chatnachrichten abgefragt werden soll.

    Einheit: Millisekunden

    listener NowChatUnreadMessagesCountListener Listener, den Sie implementieren, um die Anzahl der ungelesenen Chatnachrichten zu erhalten. Sie müssen diesen Listener auch abbestellen, wenn Sie die Anzahl der ungelesenen Nachrichten nicht mehr mit der Methode NowChatService – unsubscribeFromUnreadMessageCount(listener: NowChatUnreadMessagesCountListener) abrufen möchten.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen Listener für die Anzahl ungelesener Chatnachrichten abonnieren und abbestellen.

    private val unreadMessageCountListener = object: NowChatUnreadMessagesCountListener {
      override fun unreadMessagesCountDidChange(unreadMessageCount: Int) {
      }
    }
    
    fun setup() {
      nowChatService.subscribeToUnreadMessageCount(pollingInterval:1000, unreadMessageCountListener)
    }
    
    fun teardown() {
      nowChatService.unsubscribeFromUnreadMessageCount(unreadMessageCountListener)
    }
    

    NowChatService – unsubscribeFromUnreadMessageCount(listener: NowChatUnreadMessagesCountListener)

    Kündigt den Empfang der Anzahl ungelesener Nachrichten.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    listener NowChatUnreadMessagesCountListener Listener, den Sie implementieren, um sich vom Listener für die Anzahl ungelesener Chatnachrichten abzumelden.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen Listener für die Anzahl ungelesener Chatnachrichten abonnieren und abbestellen.

    private val unreadMessageCountListener = object: NowChatUnreadMessagesCountListener {
      override fun unreadMessagesCountDidChange(unreadMessageCount: Int) {
      }
    }
    
    fun setup() {
      nowChatService.subscribeToUnreadMessageCount(pollingInterval:1000, unreadMessageCountListener)
    }
    
    fun teardown() {
      nowChatService.unsubscribeFromUnreadMessageCount(unreadMessageCountListener)
    }