---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Now ChatService-Klasse -- Android

# Now ChatService-Klasse -- Android {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die Now Chatservice Die Klasse bietet Funktionen, mit denen Sie die Now Chat-Aktivität starten und Fehlerkonfigurationen festlegen können.

## NowChatservice -- launchIntent(context:context, themeColors:NowChatTheme):Absicht {#ariaid-title2}

Startet die Absicht, die zum Öffnen der Now Chat-Aktivität verwendet wird. Wird normalerweise zum Erstellen von verwendet `[android.App.Ausstehende Absicht] `.
{#NChatServA-launchIntent_O_O__table_yv2_43l_nrb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| context | Kontext | Kontext, der zum Erstellen der Absicht verwendet wird. |
| Themenfarben | [Now ChatTheme](https://servicenow-prod.fluidtopics.net/JmPSUA1Jx4D3enkaPuXguQ "Die Now ChatTheme Die Schnittstelle definiert Standardfarben für die Elemente in ServicemitarbeiterUnd Virtual AgentChat-UI.") | Optional. Designfarben, die in der Now Chat-UI verwendet werden sollen. Standard: Standardfarben |
[Tabelle : 1. Parameter]

{#NChatServA-launchIntent_O_O__table_yv2_43l_nrb} {#NChatServA-launchIntent_O_O__table_zv2_43l_nrb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zweck | Absichts- und Designfarben, die zum Starten der zugehörigen Now Chat-Aktivität verwendet werden. |
[Tabelle : 2. Rückgaben]

{#NChatServA-launchIntent_O_O__table_zv2_43l_nrb}  
Dieses Beispiel zeigt, wie aufgerufen wird LaunchIntent() Methode und Verarbeitung der Rückgabeaktivität.

    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, themeColors: NowChatTheme = object: NowChatTheme{}, contextData: Map\<String, Any\> = mapOf(), chatConfiguration: NowChatConfiguration? = Null) {#ariaid-title3}

Startet die angegebene Now Chat-Aktivität.
{#NChatServA-start_O_O__table_lbg_cyg_tpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Aktivität | [Aktivität](https://developer.android.com/reference/kotlin/android/app/Activity.html) | Aktivitätskontext, der zum Starten der Now Chat-Aktivität und zum Empfangen von verwendet werden soll `Now ChatExitCode `Als resultCode über OnAktivityResult . |
| Themenfarben | [Now ChatTheme](https://servicenow-prod.fluidtopics.net/JmPSUA1Jx4D3enkaPuXguQ "Die Now ChatTheme Die Schnittstelle definiert Standardfarben für die Elemente in ServicemitarbeiterUnd Virtual AgentChat-UI.") | Optional. Designfarben, die in der Now Chat-UI verwendet werden sollen. Standard: Standardfarben |
| ContextData | \<String, Any\> zuordnen | Optional. Zusätzliche Chat-Kontextvariablen, die an die Chatsitzung übergeben werden sollen. Weitere Informationen zu Chat-Kontextvariablen finden Sie unter [Live agent chat context variables](https://www.servicenow.com/docs/access?context=live-agent-chat-context-vars&version=yokohama&pubname=yokohama-conversational-interfaces&ft:locale=en-US). |
| Chatkonfiguration | [Now ChatKonfiguration](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NowChatOptionsAndroid "Die Now ChatKonfiguration Mit der Klasse 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, das Anwenden verschiedener Konversationsoptionen bei Verwendung des Chats und das Konfigurieren von UI-Komponenten in Now Chat.") | Optional. Chatkonfiguration, die bei Verwendung von Now Chat angewendet werden soll. |
[Tabelle : 3. Parameter]

{#NChatServA-start_O_O__table_lbg_cyg_tpb} {#NChatServA-start_O_O__table_mbg_cyg_tpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Rückgaben]

{#NChatServA-start_O_O__table_mbg_cyg_tpb}  
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") 
     
      //drawable to be used instead of the default NowChat back button. 
      val myDrawable = ContextCompat.getDrawable(activity, R.drawable.my_drawable) 
     
      val chatConfiguration = NowChatConfiguration( 
        closePrompt = NowChatConfiguration.ClosePrompt( 
          header = null, 
          message = "Are you sure you want to leave?", 
          acceptButtonTitle = "Yes", 
          declineButtonTitle = "No" 
        ),
        disabledFeatures = listOf(NowChatConfiguration.Feature.START_NEW_CONVERSATION), 
        conversationOptions = listOf(NowChatConfiguration.ConversationOption.FORCE_NEW_CONVERSATION), 
        uiConfiguration = NowChatConfiguration.UIConfiguration( 
          closeButton = NowChatConfiguration.CloseButton( 
            icon = myDrawable 
          ),
          attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible = false) 
        )
      )
     
      chatService?.start(activity, chatTheme, contextData, chatConfiguration) 
    } 

## NowChatService -- subscribeToUnreadMessageCount(pollingInterval: Lang, Listener: NowChatUnreadMessagesCountListener) {#ariaid-title4}

Abonniert den Listener für die Anzahl ungelesener Chatnachrichten.
{#NChatServA-subToUnreadMsgCnt_I_O__table_zrg_k1m_cqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Abfrageintervall | Lang | Häufigkeit, mit der der der Webservice nach der Anzahl der ungelesenen Chatnachrichten abgefragt werden soll. Einheit: Millisekunden |
| Listener | Now ChatUnreadMessagesCountListener | Listener, den Sie implementieren, um die Anzahl der ungelesenen Chatnachrichten abzurufen. Sie müssen auch dieses Listener abbestellen, wenn Sie die Anzahl ungelesener Nachrichten nicht mehr mit abrufen möchten [NowChatService -- unsubscribeFromUnreadMessageCount(Listener: NowChatUnreadMessagesCountListener)](https://servicenow-prod.fluidtopics.net/ApQFuXqSgjlGlPSUc7Y83g#NChatServA-unsubFromUnreadMsgCnt_O "Hebt den Empfang der Anzahl ungelesener Nachrichten ab.")Methode. |
[Tabelle : 5. Parameter]

{#NChatServA-subToUnreadMsgCnt_I_O__table_zrg_k1m_cqb} {#NChatServA-subToUnreadMsgCnt_I_O__table_asg_k1m_cqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 6. Rückgaben]

{#NChatServA-subToUnreadMsgCnt_I_O__table_asg_k1m_cqb}  
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) {#ariaid-title5}

Hebt den Empfang der Anzahl ungelesener Nachrichten ab.
{#NChatServA-unsubFromUnreadMsgCnt_O__table_inp_hbm_cqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Listener | Now ChatUnreadMessagesCountListener | Listener, den Sie implementieren, um das Abonnement des Listeners für die Anzahl ungelesener Chatnachrichten abzubestellen. |
[Tabelle : 7. Parameter]

{#NChatServA-unsubFromUnreadMsgCnt_O__table_inp_hbm_cqb} {#NChatServA-unsubFromUnreadMsgCnt_O__table_jnp_hbm_cqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Rückgaben]

{#NChatServA-unsubFromUnreadMsgCnt_O__table_jnp_hbm_cqb}  
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)
    }


