NowChatSdkCallbacks-Schnittstelle – Android

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Die NowChatSdkCallbacks Die Schnittstelle bietet Funktionen, die Rückrufe für Hostanwendungen ermöglichen, um Aktionen aus dem NowChatSDK zu konfigurieren oder zu verarbeiten.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    IsFileCollectionBlocked Boolean Kennzeichnung, die angibt, ob die Hostanwendung verhindern soll, dass NowChat die Dateiauswahl öffnet.
    Gültige Werte:
    • Wahr: Verhindern Sie, dass die Dateiauswahl geöffnet wird.
    • Falsch: Erlauben Sie, dass die Dateiauswahl geöffnet wird.
    IsGalleryCollectionBlocked Boolean Kennzeichnung, die angibt, ob die Hostanwendung verhindern soll, dass NowChat die Fotogalerie öffnet.
    Gültige Werte:
    • Wahr: Verhindern Sie, dass die Fotogalerie geöffnet wird.
    • Falsch: Erlauben Sie, dass die Fotogalerie geöffnet wird.
    IsLocationCollectionBlocked Boolean Kennzeichnung, die angibt, ob die Hostanwendung verhindern soll, dass NowChat auf die Positionierung der Positionsbestimmung zugreift.
    Gültige Werte:
    • Wahr: Zugriff auf Positionierung der Positionsbestimmung verhindern.
    • Falsch: Verhindern Sie den Zugriff auf die Positionierung der Positionsbestimmung nicht.
    IsPhotoCollection blockiert Boolean Kennzeichnung, die angibt, ob die Hostanwendung den Zugriff von NowChat auf die Kamera verhindern soll.
    Gültige Werte:
    • Wahr: Verhindern Sie den Zugriff auf die Kamera.
    • Falsch: Verhindern Sie den Zugriff auf die Kamera nicht.

    NowChatSdkCallbacks – didEndSessionWithId(sessionId: Zeichenfolge)

    Wird aufgerufen, wenn der Chat-Bildschirm geschlossen wird und die Chat-Sitzung endet.

    Hinweis:
    Sie müssen die gewünschte Funktionalität für diesen Rückruf definieren, indem Sie die Funktion überschreiben, da die Standardimplementierung einfach die Nachricht „Chatsitzung $sessionId beendet“ schreibt. Im Protokoll.
    Tabelle : 2. Parameter
    Name Typ Beschreibung
    sessionId Zeichenfolge SYS_ID der Sitzung, die beendet wurde.

    Tabelle: Konversationssitzung [sys_cs_Session]

    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wo Ihr Code platziert werden soll, um die Standardfunktionalität zu überschreiben.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun didEndSessionWithId(sessionId: String) {
        Log.i("NowChat", "Chat session $sessionId ended.")
      }
    
    //override other methods
    
    }

    NowChatSdkCallbacks – loadUri(URI: URI, context: Kontext)

    Verarbeitet den angegebenen URI, z. B. das Öffnen in einer Webansicht, einer anwenderdefinierten Registerkarte oder einem externen Browser.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    uri URI Zu öffnender URI.
    context Kontext Anwendungskontext.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun loadUri(uri: Uri, context: Context) {
    
        // Open the uri in a webview
        val webview = WebView(context)
        webview.loadUrl(uri.toString())
      }
    
      // Override other methods
    }

    NowChatSdkCallbacks – onExit(exitCode: NowChatExitCode)

    Legt den Ergebniscode fest, der zurückgegeben wird, wenn NowChat beendet wird.

    Dieser Rückruf wird aufgerufen, wenn dieser Vollbildchat geschlossen wird und der Anwender zur Hostanwendung zurückkehrt.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    exitCode NowChatExitCode Grund für das Beenden von NowChat.
    Gültige Werte:
    • ChatPluginNotInstalledError: Chat-Plugin nicht auf Instanz installiert.
    • SessionInitializationError: Sitzung mit Instanz kann nicht initialisiert werden.
    • UserExit: Anwender wurde mit der Schaltfläche „nach oben“ oder „zurück“ beendet
    • Unbekannt: Beliebiger unbekannter Grund.
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
    
      override fun onExit(exitCode: NowChatExitCode) {
        when (exitCode) {
          NowChatExitCode.UserExit -> Log.i("NowChat", "User exited using the up button or back button")
          NowChatExitCode.SessionInitializationError -> Log.i("NowChat", "Unable to initialize session with instance")
          NowChatExitCode.ChatPluginNotInstalledError -> Log.i("NowChat", " Chat plugin not installed on instance.")
          NowChatExitCode.Unknown -> Log.i("NowChat", "User exited for Unknown reason")
        }
      }
    
      // Override other methods
    }

    NowChatSdkCallbacks – provideProgressView(Kontext: Kontext)

    Gibt die Ansicht zurück, die angezeigt werden soll, wenn die NowChat-UI-Daten geladen werden; normalerweise ein konfigurierter unbestimmter Fortschrittsbalken.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    context Kontext Anwendungskontext, der zum Erstellen der Ansicht verwendet werden soll.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Anzeigen Zeigen Sie an, dass der NowChat-Service beim Laden verwendet.

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    class SampleNowChatSDKCallbacks : NowChatSdkCallbacks {
      override fun provideProgressView(context: Context): View? {
        return ProgressBar(context).apply {
          indeterminateTintList = ColorStateList.valueOf(
            MaterialColors.getColor(
              context,
              android.R.attr.colorPrimary,
              Color.BLACK)
          )
        }
    
        // Override other methods
      }
    }