Classe NowChatService : Android

La classe NowChatService fournit des fonctions qui vous permettent de lancer l’activité NowChat et de définir des configurations d’erreurs.

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

Lance l’intention utilisée pour ouvrir l’activité Now Chat. Généralement utilisé pour créer un [android.app.PendingIntent].

Tableau 1. Paramètres

Nom	Type	Description
contexte	Contexte	Contexte utilisé pour générer l’intention.
Couleurs du thème	Thème NowChatTheme	Facultatif. Couleurs de thème à utiliser dans l’interface utilisateur NowChat. Par défaut : couleurs par défaut

Tableau 2. Renvoie

Type	Description
Intention	Couleurs d’intention et de thème utilisées pour lancer l’activité NowChat associée.

Cet exemple montre comment appeler la méthode launchIntent() et traiter l’activité de retour.

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(), chatOptions : NowChatOptions ? = null)

Lance l’activité Now Chat spécifiée.

Tableau 3. Paramètres

Nom	Type	Description
activité	Activité	Contexte de l’activité à utiliser pour lancer l’activité NowChat et recevoir le NowChatExitCode en tant que resultCode via onActivityResult.
Couleurs du thème	Thème NowChatTheme	Facultatif. Couleurs de thème à utiliser dans l’interface utilisateur NowChat. Par défaut : couleurs par défaut
contextData	Map<String, N’importe lequel>	Facultatif. Variables de contexte de messagerie instantanée supplémentaires transmises dans la session de messagerie instantanée. Pour en savoir plus sur les variables de contexte de la messagerie instantanée, reportez-vous à la section Live agent chat context variables.
options de messagerie instantanée	Options de messagerie instantanée Now	Facultatif. Options à appliquer à la session de messagerie instantanée.

Tableau 4. Renvoie

Type	Description
Aucun

L’exemple de code suivant montre comment appeler cette fonction.

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) 
} 

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

S’abonne à l’écouteur de nombre de messages de messagerie instantanée non lus.

Tableau 5. Paramètres

Nom	Type	Description
intervalle d’interrogation	Long	Fréquence à laquelle interroger le service Web pour le nombre de messages de messagerie instantanée non lus. Unité : Millisecondes
auditeur	NowChatUnreadMessagesCountListener	Écouteur que vous implémentez pour obtenir le nombre de messages de messagerie instantanée non lus. Vous devez également vous désabonner de cet écouteur lorsque vous ne souhaitez plus obtenir le nombre de messages non lus à l’aide de la NowChatService : unsubscribeFromUnreadMessageCount(listener : NowChatUnreadMessagesCountListener) méthode.

Tableau 6. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment s’abonner et se désabonner d’un écouteur de nombre de messages non lus de messagerie instantanée.

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)

Se désabonne de la réception du nombre de messages non lus.

Tableau 7. Paramètres

Nom	Type	Description
auditeur	NowChatUnreadMessagesCountListener	Écouteur que vous implémentez pour vous désabonner de la messagerie instantanée Écouteur du nombre de messages non lus.

Tableau 8. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment s’abonner et se désabonner d’un écouteur de nombre de messages non lus de messagerie instantanée.

private val unreadMessageCountListener = object: NowChatUnreadMessagesCountListener {
  override fun unreadMessagesCountDidChange(unreadMessageCount: Int) {
  }
}

fun setup() {
  nowChatService.subscribeToUnreadMessageCount(pollingInterval:1000, unreadMessageCountListener)
}

fun teardown() {
  nowChatService.unsubscribeFromUnreadMessageCount(unreadMessageCountListener)
}