機能

• 最初の10秒間
• 10秒-60秒
• 1分-60分の毎分
• 1時間-24時間の毎時
• 1日-30日の毎日
• 1月-12月の毎月
• 1年目の後の毎年

• プロジェクトAssetsフォルダのアセットの名前。
• 次の例に示すように、イメージ・ソースへの外部リンク。

BotsUIManager.shared().setPersonAvatar(avatarAsset: "https://picsum.photos/200/300")
BotsUIManager.shared().setPersonAvatar(avatarAsset: "userAvatarInAssetsFolder") 

// to override avatar , name and name text colorlet agentDetails = AgentDetails(name: "Bob", avatarImage: "https://picsum.photos/200/300", nameTextColor: .red)
// to override avatar , namelet agentDetails = AgentDetails(name: "Bob", avatarImage: "https://picsum.photos/200/300")
// to override avatar, name, name text color,avatar initials color , avatar background let agentDetails = AgentDetails(name: "Bob", nameTextColor: .red,avatarTextColor: .blue,avatarBackgroundColor: .green)
BotsUIManager.shared().setAgentDetails(agentDetails: agentDetails)

let agentDetails = AgentDetails()
agentDetails.name = "Bob"
agentDetails.avatarImage = "agentAvatar"
agentDetails.nameTextColor = .red
agentDetails.avatarBackgroundColor = .green
agentDetails.avatarTextColor = .brown
BotsUIManager.shared().setAgentDetails(agentDetails: agentDetails)

let agentDetails = BotsUIManager.shared().getAgentDetails()

BotsManager.shared().shareMenuItems([ShareMenuItem.files, ShareMenuItem.camera, ShareMenuItem.location], [ShareMenuCustomItem(types: [String(kUTTypePDF)], label: "PDF Files", maxSize: 1024), ShareMenuCustomItem(types: [String(kUTTypeText)], label: "Text Files")])

BotsManager.shared().shareMenuItems();

BotsManager.shared().shareMenuItems()

BotsManager.shared().disconnect()

BotsManager.shared().connect()

var botsConfiguration = BotsConfiguration(url: url, userId: userId, channelId: channelId)
BotsManager.shared().connect(botsConfiguration: botsConfiguration)

public class ViewController: UIViewController, BotsMessageServiceDelegate {
    func beforeSend(message: [String : Any]?) -> [String : Any]? {
        // Handle before send delegate here
    }
    
    func beforeDisplay(message: [String : Any]?) -> [String : Any]? {
        // Handle before display delegate here
    }
    
    func beforeSendPostback(action: [String : Any]?) -> [String : Any]? {
        // Handle before send postback action delegate here
    }
}

BotsManager.shared().delegate = self

• onStatusChange(ConnectionStatus connectionStatus) – このメソッドは、WebSocket接続のステータスが変更されたときにコールされます。connectionStatusパラメータは、接続の現在のステータスです。ConnectionStatus列挙の詳細は、SDKに含まれるAPIドキュメントを参照してください。
• onReceiveMessage(message: BotsMessage) – このメソッドは、新しいメッセージがスキルから受信されたときにコールされます。messageパラメータは、スキルから受信されたメッセージです。BotsMessageクラスの詳細は、SDKに含まれるAPIドキュメントを参照してください。
• onUploadAttachment(message: BotsAttachmentMessage) – このメソッドは、アタッチメントのアップロードが完了したときにコールされます。messageパラメータは、アップロードされたアタッチメントのBotsAttachmentMessageオブジェクトです。
• onDestroy()– このメソッドは、destroy()メソッドが呼び出されたときに呼び出されます。
• onInitialize()– このメソッドは、initialize(botsConfiguration: BotsConfiguration, completionHandler: @escaping (ConnectionStatus, Error?) -> ())メソッドがコールされたときにコールされます。次のパラメータを取ります。
  • newLanguage– 新しく設定されたチャット言語のSupportedLanguageオブジェクト。
• beforeEndConversation()– このメソッドは、終了会話セッションが開始されたときにコールされます。
• chatEnd()– 会話が正常に終了した後にトリガーされるコールバック・メソッド。

extension ViewController: BotsEventListener {
    func onReceiveMessage(message: BotsMessage) {
        // Handle the messages received from skill or Digital Assistant
    }

    func onUploadAttachment(message: BotsAttachmentMessage) {
        // Handle the post attachment upload actions
    }

    func onStatusChange(connectionStatus: ConnectionStatus) {
        // Handle the connection status change
    }

    func onInitialize() {
        //Handle initialization
    }

    func onDestroy() {
        //Handle destroy
    }

    func onChatLanguageChange(newLanguage: SupportedLanguage) {
        //Handle the language change.
    }

    func beforeEndConversation(completionHandler: @escaping (EndConversationStatus) -> Void) {
        //Do the desired cleanup before session is closed.
        return completionHandler(.success) // if cleanup was successfull.
        return completionHandler(.success) // if there was en error cleaning up.
    }
    
     func chatEnd() {
        //Handle successfull session end from server before the SDK is destroyed.
     }
}

BotsManager.shared().botsEventListener = self

BotsProperties.LinkHandler = LinkHandlerType.webview
//Set the properties which you want changed from the default values.
BotsProperties.WebViewConfig.webViewSize = WebViewSize.full
BotsProperties.WebViewConfig.clearButtonLabelColor = UIColor.black

    botsConfiguration.multiLangChat = MultiLangChat(
            supportedLanguages:[
                SupportedLanguage.init(lang: "en", label: "English"),
                SupportedLanguage.init(lang: "fr"),
                SupportedLanguage.init(lang: "fr-CA", label: "French (Canada)")
            ],
            primaryLanguage: "fr-CA"
        )

• ドロップダウン・メニューを表示するには、少なくとも2つの言語を定義する必要があります。
• primaryLanguage属性を省略すると、ウィジェットがユーザー・プロファイルの言語を自動的に検出し、メニューの「言語の検出」オプションを選択します。
• labelキーは、ネイティブ・サポート言語ではオプションです。frはメニューでは「フランス語」と表示され、esは「スペイン語」と表示されます。
• labelはオプションですが、追加した言語がネイティブにサポートされない場合、タグを識別するラベルを追加する必要があります。たとえば、label: 'हिंदी'をlang: "hi"に対して定義しないと、ドロップダウン・メニューに「hi」がかわりに表示され、最適なユーザー・エクスペリエンスを提供できなくなります。

shareMenuItems(shareMenuItems: ([ShareMenuItem], [ShareMenuCustomItem]))

BotsManager.shared().startRecording()
if (BotsManager.shared().isRecording()) {
    BotsManager.shared().stopRecording() // Stop voice recording
}

BotsManager.shared().speak(text: "What kind of crust do you want?")

BotsManager.shared().stopSpeech()

• speak(text: String) - このメソッドは、発話キューに読み込まれるテキストを追加します。textパラメータは、使用するテキストです。
• isSpeaking() - このメソッドは、オーディオ・レスポンスが話されているかどうかをチェックします。オーディオ・レスポンスが話されていない場合は、falseを返します。
• stopSpeech() - このメソッドは、進行中の音声合成を停止します。

   class CustomTTSService: TTSService {

        func speak(text: String) {
            // Adds text to the utterance queue to be spoken
        }
        
        func stopSpeech() {
            // Stops any ongoing speech synthesis
        }
        
        func isSpeaking() -> Bool {
            // Checks whether the bot audio response is being spoken or not.
        }
    }