NowChatOptions: iOS

NowChatOptions クラスを使用すると、チャット セッションで、チャット ウィンドウを閉じる前にプロンプトを表示したり、チャットの使用中に機能を無効にしたりするなどのオプションを構成できます。

NowChatOptions - ClosePrompt(header: String?, message: String, acceptButtonTitle: String, declineButtonTitle: String)

渡されたパラメーターに基づいて ClosePrompt オブジェクトを作成して返します。次に、このオブジェクトを NowChatOptions() メソッドに渡して、チャットセッション内のプロンプトを閉じるオプションを設定します。

表 : 1. パラメーター

名前	タイプ	説明
header	文字列	プロンプトのヘッダーに表示するテキスト。 プロンプトヘッダーを表示したくない場合は、"nil" を渡します。
メッセージ	文字列	プロンプトのメインテキストとして表示するテキスト。
acceptButtonTitle	文字列	チャットウィンドウを閉じるためにプロンプトのプライマリボタンに表示するテキスト。
拒否ボタンのタイトル	文字列	プロンプトを却下するためにプロンプトのセカンダリボタンに表示するテキスト。

次のコード例は、この関数を呼び出す方法を示しています。

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)

現在のチャットセッションのオプションを設定します。このメソッドを使用すると、チャットウィンドウを閉じる前にプロンプトを表示したり、チャットの使用中に機能を無効にしたり、チャットサービスの開始時に新しいチャット会話を強制したりできます。

表 : 2. パラメーター

名前	タイプ	Description (説明)
closePrompt	ClosePrompt オブジェクト	関連するチャットウィンドウを閉じる前に表示するプロンプト。 クローズプロンプトを表示したくない場合は、"nil" を渡します。
disabledFeatures	[特徴]	現在のチャットセッション内で無効にするチャット機能のリスト。 有効な値: startNewConversation:チャットウィンドウに表示される [StartNew Conversation ] ボタンを非表示/無効にします。 使用可能なチャット機能は、 NowChatOptions.Feature 列挙型クラスで定義されています。 どの機能も無効にしたくない場合は、"nil" を渡します。
forceNewConversation	ブーリアン	チャットセッションの開始時に新しいチャット会話を強制するかどうかを示すフラグ。現在の会話はすべてクローズされます。 有効な値： true:新しいチャット会話を開始します。新しいチャットウィンドウが開きます。 false:新しいチャット会話を開始しません。既存のチャットウィンドウを使用します。 デフォルト値：false

表 : 3. 返される内容

タイプ	Description (説明)
チャットオプション	NowChatService - makeChatUI(theme: NowChatThemeable, chatOptions: NowChatOptions? = nil) -> Result<UIViewController, NowChatServiceError>) メソッドで渡すことができる chatOptions オブジェクトを返します。

次のコード例は、この関数を呼び出す方法を示しています。

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