NowChatOptions – iOS

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer
  • Mit der Klasse NowChatOptions können Sie in einer Chatsitzung Optionen konfigurieren, z. B. das Anzeigen einer Eingabeaufforderung vor dem Schließen eines Chatfensters oder das Deaktivieren von Funktionen während der Chatsitzung.

    NowChatOptions – ClosePrompt(header: Zeichenfolge?, Nachricht: Zeichenfolge, akzeptieren Schaltflächentitel: Zeichenfolge, abgelehnt Schaltflächentitel: Zeichenfolge)

    Erstellt ein ClosePrompt-Objekt und gibt es basierend auf den übergebenen Parametern zurück. Anschließend übergeben Sie dieses Objekt an die NowChatOptions()- Methode, um die Optionen zum Schließen der Aufforderung in einer Chatsitzung zu konfigurieren.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    header Zeichenfolge Text, der im Header der Eingabeaufforderung angezeigt werden soll.

    Wenn Sie keinen Eingabeaufforderungsheader anzeigen möchten, übergeben Sie „nil“.

    message Zeichenfolge Text, der als Haupttext der Eingabeaufforderung angezeigt werden soll.
    akzeptierenSchaltflächentitel Zeichenfolge Text, der auf der primären Schaltfläche der Eingabeaufforderung zum Schließen des Chat-Fensters angezeigt werden soll.
    AblehnenSchaltflächeTitel Zeichenfolge Text, der auf der sekundären Schaltfläche der Eingabeaufforderung angezeigt werden soll, die die Eingabeaufforderung schließt.

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    func makeChatScreen() -> UIViewController? {
      guard let chatService = chatService else { return nil }
      let closePrompt = NowChatOptions.ClosePrompt(
        header: "Close Window",
        message: "Are you sure you want to close the chat window?",
        acceptButtonTitle: "Yes",
        declineButtonTitle: "No")
    
      let disabledFeatures = [.startNewConversation]
        
      let chatOptions = NowChatOptions(closePrompt: closePrompt,
        disabledFeatures: disabledFeatures,
        forceNewConversation: true)
        
      let result = chatService.makeChatUI(theme: CarrascoChatTheme(chatColors: ChatColors()), chatOptions: chatOptions)
        
      switch result {
      case .success(let chatViewController):
        return chatViewController
      case .failure(let error):
        return nil
      }
    }

    NowChatOptions – NowChatOptions(closePrompt: ClosePrompt?,disabledFeatures: [Feature]?,forceNewConversation: Bool)

    Konfiguriert Optionen für die aktuelle Chatsitzung. Mit dieser Methode können Sie eine Eingabeaufforderung anzeigen, bevor Sie ein Chatfenster schließen, Funktionen während der Verwendung des Chats deaktivieren und eine neue Chatunterhaltung erzwingen, wenn der Chatservice gestartet wird.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    closePrompt ClosePrompt- Objekt Aufforderung zum Anzeigen vor dem Schließen des zugehörigen Chatfensters.

    Wenn keine Aufforderung zum Schließen angezeigt werden soll, übergeben Sie „nil“.

    disableFeatures [Funktion] Liste der Chatfunktionen, die innerhalb der aktuellen Chatsitzung deaktiviert werden sollen
    Gültiger Wert:
    • startNewConversation: Schaltfläche „ StartNew Conversation“, die in einem Chatfenster angezeigt wird, ausblenden/deaktivieren.

    Die verfügbaren Chatfunktionen sind in der Aufzählungsklasse NowChatOptions.Feature definiert.

    Wenn Sie keine Funktionen deaktivieren möchten, übergeben Sie „nil“.

    Erzwingen Sie eine neue Konversation Boolean Kennzeichnung, die angibt, ob eine neue Chatunterhaltung erzwungen werden soll, wenn die Chatsitzung beginnt. Alle aktuellen Konversationen werden geschlossen.
    Gültige Werte:
    • true: Neue Chatunterhaltung starten; Ein neues Chatfenster wird geöffnet.
    • „falsch“: Keine neue Chatunterhaltung starten. das vorhandene Chatfenster verwenden.

    Standardwert: false

    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    chatOptionen Gibt ein chatOptions-Objekt zurück, das Sie in der Methode NowChatService - makeChatUI(theme: NowChatThemeable, chatOptions: NowChatOptions? = nil) -> Ergebnis<UIViewController, NowChatServiceError> ) übergeben können.

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    func makeChatScreen() -> UIViewController? {
      guard let chatService = chatService else { return nil }
      let closePrompt = NowChatOptions.ClosePrompt(
        header: "Close Window",
        message: "Are you sure you want to close the chat window?",
        acceptButtonTitle: "Yes",
        declineButtonTitle: "No")
    
      let disabledFeatures = [.startNewConversation]
        
      let chatOptions = NowChatOptions(closePrompt: closePrompt,
        disabledFeatures: disabledFeatures,
        forceNewConversation: true)
        
      let result = chatService.makeChatUI(theme: CarrascoChatTheme(chatColors: ChatColors()), chatOptions: chatOptions)
        
      switch result {
      case .success(let chatViewController):
        return chatViewController
      case .failure(let error):
        return nil
      }
    }