Classe NowChatService : Android

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

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

Lance l’intention utilisée pour ouvrir l’activité NowChat. 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	NowChatTheme (en anglais)	Facultatif. Couleurs de thème à utiliser dans l’interface utilisateur NowChat. Valeur 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())

Lance l’activité NowChat spécifiée.

Tableau 3. Paramètres

Nom	Type	Description
activité	Activité	Contexte d’activité à utiliser pour lancer l’activité NowChat et recevoir le NowChatExitCode en tant que resultCode via onActivityResult.
Couleurs du thème	NowChatTheme (en anglais)	Facultatif. Couleurs de thème à utiliser dans l’interface utilisateur NowChat. Valeur par défaut : couleurs par défaut
Données contextuelles	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 contextuelles de messagerie instantanée, reportez-vous à la section Live agent chat context variables.

Tableau 4. Renvoie

Type	Description
Néant

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") 
  chatService?.start(activity, chatTheme, contextData)
}

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

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

Tableau 5. Paramètres

Nom	Type	Description
sondageIntervalle	Long	Fréquence à laquelle interroger le service Web pour connaître 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(écouteur : NowChatUnreadMessagesCountListener) méthode.

Tableau 6. Renvoie

Type	Description
Néant

L’exemple suivant montre comment s’abonner et se désabonner d’un écouteur de nombre de messages non lus de la 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(écouteur : 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
Néant

L’exemple suivant montre comment s’abonner et se désabonner d’un écouteur de nombre de messages non lus de la 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)
}