NowChatOptions - iOS

NowChatOptions 클래스를 사용하면 채팅 세션에서 채팅 창을 닫기 전에 프롬프트를 표시하거나 채팅을 사용하는 동안 기능을 비활성화하는 등의 옵션을 구성할 수 있습니다.

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

전달된 매개 변수를 기반으로 ClosePrompt 개체를 만들고 반환합니다. 그런 다음 이 객체를 NowChatOptions() 메서드에 전달하여 채팅 세션 내에서 프롬프트 닫기 옵션을 구성합니다.

표 1. 매개변수

이름	유형	설명
헤더	문자열	프롬프트 헤더에 표시할 텍스트입니다. 프롬프트 헤더를 표시하지 않으려면 "nil"을 전달합니다.
메시지	문자열	프롬프트의 메인 텍스트로 표시할 텍스트입니다.
acceptButtonTitle (영문)	문자열	채팅 창을 닫기 위한 프롬프트의 기본 버튼에 표시할 텍스트입니다.
declineButtonTitle (영문)	문자열	프롬프트를 해제하는 프롬프트의 보조 버튼에 표시할 텍스트입니다.

다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

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: [기능]?, forceNewConversation: bool)

현재 채팅 세션에 대한 옵션을 구성합니다. 이 방법을 사용하면 채팅 창을 닫기 전에 프롬프트를 표시하고, 채팅을 사용하는 동안 기능을 비활성화하고, 채팅 서비스가 시작될 때 새 채팅 대화를 강제 적용할 수 있습니다.

표 2. 매개변수

이름	유형	설명
close프롬프트	ClosePrompt 객체	연결된 채팅 창을 닫기 전에 표시할 프롬프트입니다. 닫기 프롬프트를 표시하지 않으려면 "nil"을 전달합니다.
disabledFeatures	[특징]	현재 채팅 세션 내에서 비활성화할 채팅 기능 목록입니다. 유효한 값: startNewConversation: 채팅 창에 나타나는 StartNew 대화 버튼을 숨기거나 비활성화합니다. 사용 가능한 채팅 기능은 NowChatOptions.Feature 열거형 클래스에 정의되어 있습니다. 기능을 비활성화하지 않으려면 "nil"을 전달하십시오.
forceNew대화	부울	채팅 세션이 시작될 때 새 채팅 대화를 강제 적용할지 여부를 나타내는 플래그입니다. 현재 대화가 모두 종결됩니다. 유효한 값은 다음과 같습니다. true: 새 채팅 대화를 시작합니다. 새 채팅 창이 열립니다. false: 새 채팅 대화를 시작하지 않습니다. 기존 채팅 창을 사용합니다. 기본값: false

표 3. 반환

유형	설명
chatOptions	메서드에 NowChatService - makeChatUI(테마: NowChatThemeable, chatOptions: NowChatOptions? = nil) - > 결과<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
  }
}