アプリケーション開発設定

ここでは、iOSチャネルのアプリの開発に使用できる設定への参照を示します。

機能フラグ設定の初期化

コンストラクタの1つを使用してBotsConfigurationオブジェクトを初期化します。

clientAuthDisabled
- BotsConfiguration(url: String, userId: String, channelId: String)
  - パラメータ:
    - url - Oracle Chat ServerのURL。これはnullにできません。
    - userId - ユーザーの一意の識別子。これはnullにできません。
    - channelId - Oracle iOSチャネルID。これはnullにできません。
  - userIdが指定されない場合(かわりにランダム生成値が使用されます)
    - url - Oracle Chat ServerのURL。これはnullにできません。
    - channelId - Oracle iOSチャネルID。これはnullにできません。
clientAuthEnabled
- BotsConfiguration(url: String, authToken: String)
  - パラメータ:
    - url - Oracle Chat ServerのURL。これはnullにできません。
    - authToken - 認証が有効なチャネルとの接続を確立するための認証トークン。これはnullにできません。

例:

// Initialize a BotsConfiguration object
var botsConfiguration = BotsConfiguration(url: chatServerUrl, authToken: token)
 
// Set the feature flag values if the desired values are different from the default values
botsConfiguration.showConnectionStatus = true
botsConfiguration.enableBotAudioResponse = true
botsConfiguration.disablePastActions = "none"

ネットワーク構成

プロパティ名	説明	必須?	デフォルトの値
`url`	Oracle Chat ServerのURL	はい	N/A
`channelId`	Oracle iOSチャネルのID。	はい	N/A
`userId`	ユーザーの一意の識別子。この値が指定されていない場合、SDKによって初期化されます。	いいえ	ランダム生成値
`authToken`	認証が有効なチャネルとの接続を確立するための認証トークン。	はい	N/A

機能フラグ

プロパティ	説明	必須?	デフォルトの値
`disablePastActions`	ユーザーがすでに対話したメッセージのボタン・クリックを無効化するフィールド。許可される値は、`all`、`none`および`postback`です。このプロパティによって有効になる動作は、過去のアクションの選択を無効化するデジタル・アシスタント・レベルの構成とは関係ありません。2つを別々に設定する必要があります。	いいえ	`all`
`displayPreviousMessages`	ユーザーのローカルの会話履歴を有効または無効にします。	いいえ	`false`
`enableAgentSneakPreview`	有効にすると、ユーザーがメッセージを送信する前であっても、エージェントは入力中のユーザー・メッセージを表示できます。それ以外の場合は、`...`がエージェントに送信されます。	いいえ	`false`
`enableAttachment`	チャット・アプリケーションでのアタッチメントの共有を構成します。	いいえ	`true`
`enableAttachmentSecurity`	`true`に設定すると、追加のヘッダーが添付アップロード・リクエストに渡されます。これにより、有効な署名付きのJWTトークンを認可ヘッダーとして渡さない場合は、添付をダウンロードできないようになります。ノート: スキルが接続するODAインスタンスがバージョン20.08の場合、または20.08より前のバージョンで実行されている場合は、この設定を有効にしないでください。このプロパティは、ODAプラットフォームのバージョン20.12以降へのクライアント認証対応接続にのみ適用されます。	いいえ	`false`
`enableAutoSendSpeechResponse`	`true` (デフォルト)に設定されている場合、ユーザーの音声レスポンスはチャット・サーバーに自動的に送信されます(送信メッセージとしてチャット・ウィンドウにレンダリングされます)。`false`に設定されている場合、ユーザーの音声レスポンスは、チャット・サーバーに送信される前にメッセージ・テキスト・フィールドにレンダリングされるため、手動で送信する前に変更したり、メッセージを削除したりできます。	いいえ	`true`
`enableClearMessage`	チャット・ウィジェット・ヘッダーにあるメッセージのクリア・ボタンを有効化します。	いいえ	`false`
`enableDefaultClientResponse`	`true`に設定すると、スキル・レスポンスが遅延した場合、またはスキルからのレスポンスがない場合、クライアントはデフォルトのレスポンスを表示します。	いいえ	`false`
`enableEndConversation`	ユーザーが会話を終了し、チャット・セッションをリセットできるようにします。また、ローカルの会話履歴をクリアし、チャット・サーバーから切断し、ウィジェットを最小化します。	いいえ	`true`
`enableSendTypingStatus`	ユーザー入力ステータスの送信を制御します。	いいえ	`false`
`enableSpeechRecognition`	マイクロフォン・ボタンを有効化します。	いいえ	`false`
`enableSpeechSynthesis`	スキル・レスポンスの読上げを有効化します。このフラグを`true`に設定すると、Swift APIを使用してスキルのレスポンスを読み上げることができます。	いいえ	`false`
`enableTimestamp`	メッセージのタイムスタンプを有効化します。`timestampMode`設定を使用して、タイムスタンプ表示モードを絶対または相対として設定できます。	いいえ	`true`
`headerLogo`	ヘッダーに配置される`UIImage`オブジェクトを渡します。デフォルトの位置はヘッダーの左側です。右側に配置するには、`headerLogoAlignment`プロパティを`NSTextAlignment.right`に設定します。	いいえ	N/A
`headerLogoAlignment`	ヘッダー・ロゴの位置を設定します(渡された場合)。	いいえ	`NSTextAlignment.left`
`initSpeechSynthesisMuted`	`BotAudioResponse`のデフォルト状態をミュートまたはミュート解除に設定します。	いいえ	`true`
`initUserHiddenMessage`	会話を開始するために使用されるユーザー・テキスト・メッセージ。このメッセージは、チャット・ウィジェットの準備が完了すると送信され、実際にはチャットに表示されません。	いいえ	N/A
`initUserProfile`	会話の開始前にユーザー・プロファイルを初期化します。プロファイル・ペイロードのフォーマットは`["profile": […] ]`である必要があります。例: `initUserProfile = ["profile": ["givenName": "First", "surname": "Last", "email": "first.last@example.com", "properties": ["lastOrderedItems": "1 medium pepperoni"]]]` この機能は、最初の非表示メッセージが`initUserHiddenMessage`によって送信され、会話が開始される前に、ユーザー・コンテキストを更新します。その結果、ユーザーへの最初のレスポンス・メッセージにユーザー・プロファイルを反映できます。たとえば、スキルで次のようなメッセージをユーザーに表示できます。「おかえりなさい、John Smithさん。最後のオーダーは、ミディアムのペパロニ・ピザでした。」	いいえ	N/A
`multiLangChat`	チャット・ウィジェットがユーザーの言語を検出できると同時に、そのユーザーが会話のヘッダーのドロップダウン・メニューから優先言語を選択できるようになります。
`reconnectMaxAttempts`	初期接続が失敗したときにチャット・ウィジェットが再接続を試行した回数。	いいえ	5
`sharePopupConfiguration`	ユーザーは、アタッチメント・メニューの一部として使用可能なオプションを選択できるようになります。デフォルト値は、すべてのオプションのリストに設定されます。	いいえ	`[.photoAndVideoLibrary, .files, .camera]`
`showConnectionStatus`	チャット・ウィジェット・ヘッダーに接続ステータスを表示できるようにします。	いいえ	`false`
`showTypingStatus`	スキルのレスポンスを待機しているときに入力インジケータが表示されます。	いいえ	`true`
`speechLocale`	音声認識に使用されるユーザーの音声の想定されたロケール。英語(米国) (`'en-US'`)がデフォルト・ロケールです。その他のサポートされるロケールは、英語(オーストラリア) (`'en-au'`)、英語(英国) (`'en-uk'`)、フランス語(`'fr-fr'`)、ドイツ語(`'de-de'`)、イタリア語(`'it-it'`)、ポルトガル語(ブラジル) (`'pt-br'`)、スペイン語(`'es-es'`)です。音声ロケールは、`setSpeechLocale('<locale>')` APIをコールして動的に設定できます。サポートされていないロケールが渡された場合、音声認識は機能しません。	いいえ	`en-us`
`speechSynthesisVoicePreferences`	言語ロケールと音声名の両方に基づいて、指定されたプリファレンスを照合します。一致が検出されない場合は、指定された言語ロケールのデフォルト音声が使用されます。後者の場合、Apple APIは、指定された言語ロケールとの最適一致を検出します。	いいえ	N/A
`timestampFormat`	メッセージに付随する配信タイムスタンプをフォーマットします。タイムスタンプ・フォーマットはSwift DateFormatterでサポートされている必要があります。	いいえ	`E MMM d, HH:mm a`
`timestampMode`	`enableTimestamp`を`true`に設定してタイムスタンプを有効にした場合、タイムスタンプ・モードを、各メッセージに表示される絶対タイムスタンプ、または最新のメッセージにのみ表示される相対タイムスタンプとして設定できます。 `TimestampMode.default` – 各メッセージに対する絶対タイムスタンプを設定します。 `TimestampMode.relative` – タイムスタンプは、一日の最初のメッセージの前に絶対タイムスタンプとしてヘッダーに表示され、その後、新しいメッセージの相対タイムスタンプが、そのメッセージが会話に追加されてからの経過時間を示す更新タイムスタンプとして表示されます。相対タイムスタンプは、新しいメッセージが受信されるまで、設定された間隔で更新されます。	いいえ	`TimestampMode.relative`
`title`	アプリケーション・バーに表示されるアプリケーションのタイトルを設定します。	いいえ	N/A
`ttsService`	テキスト読み上げ(TTS)サービスの注入に使用される`TTSService`型のインスタンス。`enableSpeechSynthesis`が`true`に設定されている場合にのみ適用されます。	いいえ
`typingStatusInterval`	入力イベントおよび入力ステータスの送信を抑制する間隔(秒)。	いいえ	`3`
`typingStatusTimeout`	チャット・サーバーからレスポンスが受信されていない場合に入力ステータス・インジケータを非表示にするタイムアウト(秒)を設定します。	いいえ	`30 secs`

Strings

アプリケーションの<language-code>.iproj/Localizable.stringsファイルに次のキー=値ペアを追加して、文字列を構成します。

キー	説明	デフォルトの値
`connectionFailureMessage`	`reconnectMaxAttempts`で設定された試行回数を超過した後に表示されるメッセージ。	`Sorry, the assistant is unavailable right now. If the issue persists, contact your help desk.`
`connectionRetryLabel`	`connectionFailureMessage`とともに表示される再試行ボタンのデフォルトの文字列。	`Try Again`
`end_conversation_action_yes`	セッション終了確認プロンプトの「確認」ボタンのテキスト。	`Yes`
`end_conversation_alert_message`	会話終了確認プロンプトのメッセージ本文。	`This will also clear your conversation history`
`end_conversation_alert_no`	セッション終了確認プロンプトの「拒否」ボタンのテキスト。	`No`
`end_conversation_alert_title`	会話終了確認プロンプトのタイトル。	`Are you sure you want to end the conversation?`
`odais_access_label_audio_attachment`	オーディオ・アタッチメント・メッセージのアクセシビリティ・ラベル	`audio attachment`
`odais_access_label_button_attach`	アタッチメントのアップロード・ボタンのアクセシビリティ・ラベル。	`Upload attachment`
`odais_access_label_button_audio_reponse_off`	ミュートされたボリューム・ボタンのアクセシビリティ・ラベル	`Unmute audio response`
`odais_access_label_button_audio_reponse_on`	ミュート解除されたボリューム・ボタンのアクセシビリティ・ラベル。	`Mute audio response`
`odais_access_label_button_back`	戻るボタンのアクセシビリティ・ラベル。	`Go back`
`odais_access_label_button_card_navigation_left`	水平カード・ビューの左ナビゲーション・ボタンのアクセシビリティ・ラベル。	`Card navigation right`
`odais_access_label_button_card_navigation_right`	水平カード・ビューの右ナビゲーション・ボタンのアクセシビリティ・ラベル。	`Card navigation left`
`odais_access_label_button_clear`	「メッセージのクリア」ボタンのアクセシビリティ・ラベル	`Clear messages`
`odais_access_label_button_keyboard`	キーボード・ボタンのアクセシビリティ・ラベル。	`Enter message`
`odais_access_label_button_overflow`	オーバーフロー・メニュー・ボタンのアクセシビリティ・ラベル。	`Open Menu`
`odais_access_label_button_select_language`	`The accessibility label for select language button.`	`Select Language`
`odais_access_label_button_send`	送信ボタンのアクセシビリティ・ラベル	`Send message`
`odais_access_label_button_speak`	マイク・ボタンのアクセシビリティ・ラベル	`Speak message`
`odais_access_label_card_desc`	カード説明のアクセシビリティ・ラベルで、その後にテキストが続きます	`card description`
`odais_access_label_card_title`	カード・タイトルのアクセシビリティ・ラベルで、その後にテキストが続きます	`card title`
`odais_access_label_chat_status`	チャット・ステータスのアクセシビリティ・ラベルで、その後にステータス文字列が続きます	`Chat status`
`odais_access_label_chat_title`	チャット・タイトルのアクセシビリティ・ラベルで、その後にチャット・タイトル文字列が続きます	`Chat title`
`odais_access_label_file_attachment`	ファイル・アタッチメント・メッセージのアクセシビリティ・ラベル	`file attachment`
`odais_access_label_footer_text`	フッター・テキストのアクセシビリティ・ラベルで、その後にテキストが続きます	`footer text`
`odais_access_label_header_text`	ヘッダー・テキストのアクセシビリティ・ラベルで、その後にテキストが続きます	`header text`
`odais_access_label_image_attachment`	イメージ・アタッチメント・メッセージのアクセシビリティ・ラベル	`image attacment`
`odais_access_label_location_message`	ロケーション・メッセージのアクセシビリティ・ラベルで、その後にロケーション・メッセージ・タイトル、緯度および経度が続きます	`location message`
`odais_access_label_pause`	一時停止ボタンのアクセシビリティ・ラベル。	`Pause`
`odais_access_label_play`	再生ボタンのアクセシビリティ・ラベル	`Play`
`odais_access_label_skill`	VoiceOverによって読み取られるスキル・メッセージ・ペイロードのアクセシビリティ・ラベル(iOSアクセシビリティ機能)。その後、このラベルにはメッセージ固有のラベルが付加されます。	`Skill`
`odais_access_label_text_message`	テキスト・メッセージのアクセシビリティ・ラベルで、その後にテキストが続きます	`text message`
`odais_access_label_user`	VoiceOverによって読み取られるユーザー・メッセージ・ペイロードのアクセシビリティ・ラベル(iOSアクセシビリティ機能)。その後、このラベルにはメッセージ固有のラベルが付加されます。	`User`
`odais_access_label_video_attachment`	ビデオ・アタッチメント・メッセージのアクセシビリティ・ラベル	`video attachment`
`odais_access_label_webview_clear_button`	ウィジェット内WebビューのWebビュー・クリア・ボタンのアクセシビリティ・ラベル。	`Close webview`
`odais_access_label_webview_title`	ウィジェット内Webビューのタイトルのデフォルトのアクセシビリティ・ラベル。	`Webview title`
`odais_alert`	音声やファイル関連のエラーに対して表示されるアラート・メッセージのタイトル。	`Alert`
`odais_camera`	デバイスのカメラを使用するためのアタッチメント・ポップアップに表示されるアクション・テキスト。	`Camera`
`odais_camera_permission_denied`	カメラへのアクセスが許可されていない場合に表示されるエラー・メッセージ。	`Camera permission denied.`
`odais_chat_title`	アプリケーション・バーに表示されるアプリケーションのタイトル。	`Digital Assistant`
`odais_check_url`	破損したリンクに対してWebビューに表示されるエラー・メッセージ。	`Please check the url!`
`odais_clear_chat`	オーバーフロー・メニューのチャット・ボタンのクリア・タイトル。	`Clear Chat`
`odais_connected`	チャット・ウィジェットとOracle Chat Server間の接続が確立されたときに表示されるステータス・テキスト。	`Connected`
`odais_connecting`	チャット・ウィジェットがOracle Chat Serverに接続している間に表示されるステータス・テキスト。	`Connecting`
`odais_default_greeting_message`	デフォルトの挨拶応答。	`Hey, Nice to meet you! Allow me a moment to get back to you.`
`odais_default_sorry_message`	メッセージの待機時間が期限切れになったときのデフォルトのレスポンス。	`I'm sorry. I can't get you the right content. Please try again.`
`odais_default_wait_message`	スキル・メッセージの待機中に表示されるデフォルトのレスポンス。	`I'm still working on your request. Thank you for your patience!`
`odais_disconnected`	チャット・ビューとOracle Chat Server間の接続がクローズされたときに表示されるステータス・テキスト。	`Disconnected`
`odais_done`	チャット・ビューを閉じるボタンのラベル・テキスト。	`Done`
`odais_download_attachment_folder`	添付ファイルを保存するためにアプリケーション・フォルダ内に作成されたフォルダの名前。デフォルト値が空の文字列です。	空の文字列。
`odais_error`	Webビュー関連のエラーおよびアラート・メッセージのタイトル。	`Error`
`odais_fail_to_load`	Webビューにページをロードできない場合に表示されるエラー・メッセージ。中カッコ(`{}`)内のテキストは、デフォルトのブラウザで開くリンクとリンクされます。	`Sorry, we can't open this page in the chat window. Click {here} to open it in your browser.`
`odais_file_not_supported`	ユーザーがアタッチメントでサポートされていないファイル・タイプを選択したときに表示されるアラート・メッセージ。	`File type not supported`
`odais_file_size_warning`	アタッチメントに選択したファイルが最大アタッチメント・サイズ制限を超過しているときに表示されるアラート・メッセージ。テキスト`{0}`は、最大添付サイズ制限セットに置き換えられます。デフォルトの最大アタッチメント・サイズ制限は25MBです。	`You can only attach files of size up to {0}MB.`
`odais_files`	ストレージからファイルを選択するためのアタッチメント・ポップアップに表示されるアクション・テキスト。	`Files`
`odais_gallery_permission_denied`	ギャラリに対する権限が付与されていないときに表示されるアラート・メッセージ。	`You don't have permission to access gallery.`
`odais_language_ar`	特に指定がないかぎり、ドロップダウン・メニューにアラビア語を表示するデフォルトの文字列。	`Arabic`
`odais_language_de`	特に指定されていないかぎり、ドロップダウン・メニューにドイツ語を表示するデフォルトの文字列。	`German`
`odais_language_detect`	特に指定されていないかぎり、ドロップダウン・メニューに「言語の検出」を表示するためのデフォルトの文字列。	`Detect Language`
`odais_language_en`	特に指定されていないかぎり、ドロップダウン・メニューに英語を表示するデフォルトの文字列。	`English`
`odais_language_es`	特に指定されていないかぎり、ドロップダウン・メニューにスペイン語を表示するデフォルトの文字列。	`Spanish`
`odais_language_fr`	特に指定されていないかぎり、ドロップダウン・メニューにフランス語を表示するデフォルトの文字列。	`French`
`odais_language_it`	特に指定されていないかぎり、ドロップダウン・メニューにイタリア語を表示するためのデフォルトの文字列。	`Italian`
`odais_language_nl`	特に指定されていないかぎり、ドロップダウン・メニューにオランダ語を表示するためのデフォルトの文字列。	`Dutch`
`odais_language_pt`	特に指定されていないかぎり、ドロップダウン・メニューにポルトガル語を表示するためのデフォルトの文字列。	`Portuguese`
`odais_location_disabled`	位置情報サービスが無効の場合に表示されるエラー・メッセージ。	`Location services not enabled. Please enable the Location Services switch in Settings > Privacy.`
`odais_location_fetch_error`	SDKがデバイスの現在位置を取得できない場合に表示されるエラー・メッセージ。	`Error in getting device location. Please check location settings or try again.`
`odais_location_permission_denied`	位置情報へのアクセスが許可されていない場合に表示されるエラー・メッセージ。	`Location Permission Denied.`
`odais_mute`	オーバーフローメニューのミュートボタンのタイトル。	`Mute`
`odais_no_speech_error`	音声コンテンツが音声サーバーに送信されない(ユーザーが話していない)ときに表示されるアラート・メッセージ。	`Could not detect the voice, no message sent.`
`odais_notification_title`	通知バーに表示されるタイトル。	`OracleChatBot`
`odais_ok`	アラートおよびエラー・メッセージを閉じるボタンのラベル・テキスト。	`Ok`
`odais_photo`	電話のギャラリからファイルを選択するためのアタッチメント・ポップアップに表示されるアクション・テキスト。	`Photo & Video Library`
`odais_select_language`	オーバーフロー・メニューの言語選択ボタンのタイトル。	`Select Language`
`odais_speak_your_message`	音声モードでのユーザー・メッセージ入力フィールドのプレースホルダ・テキスト	`Start speaking`
`odais_speech_cancel`	記録されたオーディオの音声サーバーへの送信を取り消すための音声ポップアップ上のボタン・ラベル・テキスト。	`CANCEL`
`odais_speech_error`	オーディオを記録できないときに表示されるアラート・メッセージ。	`Error in voice recognition. Please try again later.`
`odais_speech_permission_denied`	マイクロフォンの使用が許可されないときに表示されるエラー・メッセージ。	`Permission_Denied`
`odais_speech_start`	ユーザーが発言を開始できることを示す、音声ポップアップ上に表示されるテキスト。	`Listening...`
`odais_speech_unsupported_locale`	設定された音声ロケールが音声サーバーでサポートされていない場合に表示されるエラー・メッセージ。	`The set speech locale is not supported. Cannot start recording.`
`odais_stars_rating`	ユーザーがアクセシビリティ・モード中にフィードバック・ボタンをクリックしたときに読み上げられるメッセージ	`Rate {0} star`
`odais_subtitle`	ヘッダーでタイトルの下に表示されるチャット・ウィジェットのサブタイトル。`showConnectionStatus`が`true`に設定され、サブタイトルも設定されている場合、接続ステータスのかわりにサブタイトルが表示されます。	N/A
`odais_timestamp_days`	直前のメッセージが受信されてから毎日表示される相対タイムスタンプ。`{0}`は、経過した日数で置き換えられます。	`{0}d ago`
`odais_timestamp_hours`	直前のメッセージの受信後24時間に毎時間表示される相対タイムスタンプ。`{0}`は、経過した時間数で置き換えられます。	`{0}hr ago`
`odais_timestamp_minutes`	最後のメッセージが受信されてから毎分表示される相対タイムスタンプ。`{0}`は、経過した分数で置き換えられます。	`{0}min ago`
`odais_timestamp_months`	直前のメッセージが受信されてから毎月表示される相対タイムスタンプ。`{0}`は、経過した月数で置き換えられます。	`{0}mth ago`
`odais_timestamp_now`	新規メッセージに表示される相対タイムスタンプ。	`Now`
`odais_timestamp_seconds`	相対タイムスタンプ。メッセージが受信された10秒後から、最後のメッセージが受信されてから60秒経過するまで表示されます。	`A few seconds ago`
`odais_timestamp_years`	直前のメッセージが受信されてから毎年表示される相対タイムスタンプ。`{0}`は、経過した年数で置き換えられます。	`{0}yr ago`
`odais_too_much_speech_error`	音声サーバーに一度に送信されたオーディオ・コンテンツが多すぎる(ユーザーの音声が長すぎる)ときに表示されるアラート・メッセージ。	`Too much voice input to recognize. Cannot generate recognized text.`
`odais_type_your_message`	ユーザー・メッセージ入力フィールドのプレースホルダ・テキスト。	`Enter message`
`odais_unmute`	オーバーフローメニューのミュート解除ボタンのタイトル。	`Unmute`
`odais_upload_attachment`	添付ファイルがアップロード中であることを示すバブル内に表示されるテキスト。	`Uploading attachment`
`odais_upload_attachment_error`	添付ファイルをアップロードできない場合に表示されるエラー・メッセージ。	`Error in uploading attachment`
`odais_zero_byte_file_warning`	選択したファイルのバイト数がゼロ(0)の場合に表示されるアラート・メッセージ。	`Files of size zero bytes can not be uploaded.`
`editFieldErrorMessage`	ユーザーが入力した値がそのフィールドに無効な場合に表示されるフィールド・レベルのエラー・メッセージ。スキルがクライアント・エラー・メッセージを提供しない場合、SDKはデフォルトでこのメッセージに設定されます。	`Field Input is invalid`
`editFormErrorMessage`	クライアント側検証用のフォームの送信アクションの下に表示されるフォーム・レベルのエラー・メッセージ。このメッセージは、少なくとも1つのフィールドが有効ではなく、複数のフィールドが存在する場合に表示されます。スキルがメッセージ・ペイロードにエラー・メッセージを提供しない場合、SDKはデフォルトでこのメッセージに設定されます。	`Some of the fields need your attention.`
`noResultText`	複数選択リスト・ビューでユーザー検索から一致がない場合に表示されるステータス・テキスト。	`No more results`

UIのプロパティと色

BotsProperties.<component name> = <UIColor type>を使用して、次のコンポーネントの色を変更できます。アプリケーションでのSDKの初期化の説明に従って、ビュー・コントローラにチャット・ビューを追加する前に、BotsPropertiesですべての色を設定する必要があります。

コンポーネント	説明	値
`ActionBorderColor`	アクション・ボタンの枠線の色	`161513.withAlphaComponent(0.50)`
`ActionButtonColor`	アクション・ボタンの色	`UIColor.clear`
`ActionLabelTextColor`	アクション・ラベルのテキストの色	`#161513`
`AgentAvatarBackgroundColor`	エージェント・アバターが指定されておらず、エージェント名のイニシャルがその場所に表示される場合のアバター・レイアウトの背景色	`#A890B6`
`AgentAvatarTextColor`	エージェント・アバター・レイアウト内に表示されるエージェント名のイニシャルのテキスト色。	`UIColor.white`
`AgentNameTextColor`	エージェント・メッセージの上に表示されるエージェント名に使用されるテキストの色。	`#161513.withAlphaComponent(0.65)`
`AttachmentBackgroundColor`	添付メッセージの背景色。	`UIColor.white`
`AttachmentBorderColor`	添付メッセージの背景色。	`#161513`
`AttachmentIconColor`	添付メッセージのアイコンの色。	`#161513`
`AttachmentTextColor`	添付メッセージのテキストの色。	`#161513`
`BotMessageColor`	スキルによって送信されるテキスト、アタッチメントおよびロケーション・メッセージの背景色	`UIColor.white`
`BotTextColor`	スキルによって送信されるテキスト・メッセージのテキストの色	`#161513`
`CardActionBorderColor`	カード・アクション・ボタンの枠線の色	`#161513.withAlphaComponent(0.50)`
`CardActionButtonColor`	カード・アクション・ボタンの色	`UIColor.clear`
`CardActionLabelTextColor`	カード・アクション・ラベルのテキストの色	`UIColor.white`
`CardBackgroundColor`	カードの背景色	`UIColor.white`
`CardDescriptionTextColor`	カード説明のテキストの色	`#161513`
`CardNavigationArrowColor`	水平カード・ビューのナビゲーション・ボタン矢印の色	`#161513`
`CardNavigationButtonColor`	水平カード・ビューのナビゲーション・ボタンの色	`#FBF9F8`
`CardTitleTextColor`	カード・タイトルのテキストの色	`#161513`
`ChatBackgroundColor`	チャット・ビューの背景色	`#F5F4F2`
`conversationBeginPosition`	会話の開始点を上または下に設定します。	値は、`top`および`bottom`です。デフォルトは`bottom`です。
`EnableArrowsForHorizontalCards`	`true`に設定すると、水平カード・ビューのナビゲーション矢印が有効になります。`false`に設定すると無効になります。	`false`
`FooterColor`	フッターの背景色。	`UIColor.white`
`FooterIconsColor`	フッターに配置されたアタッチメント、送信およびマイク・アイコンの色。	`#161513`
`FooterInlineIconsColor`	テキスト入力フィールド内のアイコン(ある場合)の色	`#004C8C`
`GlobalActionBorderColor`	グローバル・アクション・ボタンの枠線の色	`#161513.withAlphaComponent(0.50)`
`GlobalActionButtonColor`	グローバル・アクション・ボタンの色	`#0077C2`
`GlobalActionLabelTextColor`	グローバル・アクション・ラベルの色	`#161513`
`HeaderColor`	ヘッダーの背景色	`#F1EFED`
`HeaderIconsColor`	メッセージのクリア、ボリュームおよびミュート・ヘッダー・アイコンの色。	`#161513`
`HeaderTextColor`	接続ステータス、入力ステータスおよびチャット・タイトル・ヘッダー・アイテムのテキストの色	`#161513`
`InputFieldColor`	テキスト入力フィールドの背景色	`#161513`
`InputFieldTextColor`	テキスト入力フィールドのテキストの色	`#161513`
`IsRTL`	`true`に設定すると、UIの向きが反転して、右から左に記述する言語(アラビア語など)のレイアウトがサポートされます。`false`に設定すると、左から右に記述する言語(英語など)のデフォルトUIレイアウトになります。	`false`
`LinkHandler`	メッセージ・ペイロードの一部としてチャット・ウィジェットに表示されるリンクを開く方法を設定します。使用可能な値は、`LinkHandlerType.browser`および`LinkHandlerType.webview.`ですこの動作は、アクション・タイプを`url`から`webview`に変更することで、`beforeDisplay()`デリゲートを使用して特定のURLアクションに対してオーバーライドできます。	`LinkHandlerType.browser`
`PopupBackgroundColor`	ポップアップビューの背景色。	`UIColor.white`
`PopupIconColor`	ポップアップ・ビューのアイコンの色。	`#161513`
`PopupTextColor`	ポップアップ・ビューのテキストの色。	`#161513`
`RatingStarColor`	ユーザーが選択したフィードバック・ボタンの色。	`UIColor.white`
`RatingStarColorFill`	ユーザーが選択した後のフィードバック・ボタンの色。	`#0077C2`
`saveClickedImagesInGallery`	`true` (デフォルト)に設定すると、スキル・ユーザーがiPhone Cameraアプリケーションによってキャプチャしたイメージはギャラリに保存され、添付としてスキルに直接アップロードされます。これらのイメージをギャラリに保存しない場合は、このフラグを`false`に設定します。	`true`
`SpeechVisualizationColor`	音声視覚化バーの色	`#161513`
`SpeechVisualizerContainerBackground`	音声視覚化ビューの背景色	`UIColor.white`
`Theme`	アプリケーションのUIテーマ。有効な値は、`BotUITheme.REDWOOD_DARK`および`BotUITheme.DEFAULT`です。`REDWOOD_DARK`テーマの場合は、`#201E1C`をお薦めします。`DEFAULT`テーマの場合は、`#004C8C`です。サンプル・アプリケーションを使用してナビゲーション・バーの色を設定します。	`BotUITheme.DEFAULT`
`TimestampColor`	メッセージ・タイムスタンプの色	`#161513.withAlphaComponent(0.65)`
`UserMessageColor`	ユーザー・メッセージの背景色	`#E4E1DD`
`UserTextColor`	ユーザーによって送信されるテキスト・ユーザーのテキストの色	`#161513`
`WebViewConfig`	すべてのフィールドにデフォルト値が設定された構造体`WebViewConfiguration`のインスタンスです。	Webビューの構成を設定します。

アイコン

クライアント・アプリケーションにアイコン・イメージ・アセットの名前を設定することで、次のアイコンをカスタマイズできます。

アイコン	イメージ・アセット名
エージェント・アバター	`"agentAvatar"`
添付ボタン	`"attachmentButton"`
スキルアバター	`"botAvatar"`
ボタンのクリア	`"clearButton"`
終了会話フローを起動するクローズ・ボタン	`"closeButton"`
ダウンロード	`"downloadAttachmentButton"`
ファイル添付のファイル・アイコン	`"file"`
キーボード・ボタン	`"keyboardButton"`
水平カードの左矢印	`"leftArrow"`
マイク・ボタン	`"micButton"`
個人アバター	`"personAvatar"`
フィードバック・コンポーネント・ボタンに使用される評点アイコン	`"ratingIcon"`
水平カードの右矢印	`"rightArrow"`
送信ボタン	`"sendButton"`
言語選択ポップアップを起動するボタン	`"selectLanguageButton"`
ヘッダーに3つ以上のアクション・ボタンがある場合のオーバーフロー・メニュー・ボタン。	`"overflowButton"`
「Volume Off」ボタン	`"volumeOffButton"`
ボリューム・オン・ボタン	`"volumeOnButton"`
ズーム	`"imageZoomButton"`