Impostazioni sviluppo applicazioni

Ecco un riferimento alle impostazioni che puoi utilizzare nello sviluppo dell'app per il tuo canale iOS.

Inizializza impostazioni flag funzione

Inizializza l'oggetto BotsConfiguration utilizzando uno dei relativi costruttori.

clientAuthDisabled
- BotsConfiguration(url: String, userId: String, channelId: String)
  - Parametri:
    - url: l'URL di Oracle Chat Server. Non può essere nullo.
    - userId: l'identificativo univoco dell'utente. Non può essere nullo.
    - channelId: l'ID canale Oracle iOS. Non può essere nullo.
  - Quando userId non viene fornito (viene invece generato in modo casuale)
    - url: l'URL di Oracle Chat Server. Non può essere nullo.
    - channelId: l'ID canale Oracle iOS. Non può essere nullo.
clientAuthEnabled
- BotsConfiguration(url: String, authToken: String)
  - Parametri:
    - url: l'URL di Oracle Chat Server. Non può essere nullo.
    - authToken: il token di autenticazione per stabilire una connessione con un canale abilitato all'autenticazione. Non può essere nullo.

Ad esempio:

// 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"

Configurazione rete

Nome proprietà	descrizione;	Richiesto?	Valore predefinito
`url`	URL di Oracle Chat Server	Sì	N/A
`channelId`	ID del canale Oracle iOS.	Sì	N/A
`userId`	Identificativo univoco dell'utente. Questo valore viene inizializzato dal kit SDK se non viene fornito.	No	Valore generato in modo casuale
`authToken`	Token di autenticazione per stabilire una connessione con un canale abilitato per l'autenticazione.	Sì	N/A

Flag funzioni

Proprietà	descrizione;	Richiesto?	Valore predefinito
`disablePastActions`	Un campo per la disabilitazione del pulsante fa clic sui messaggi con cui un utente ha già interagito. I valori consentiti sono `all`, `none` e `postback`. Il funzionamento abilitato da questa proprietà è indipendente dalla configurazione a livello di assistente digitale per la disabilitazione della selezione delle azioni precedenti. È necessario impostare i due separatamente.	No	`all`
`displayPreviousMessages`	Abilita o disabilita la cronologia delle conversazioni locali dell'utente.	No	`false`
`enableAgentSneakPreview`	Se abilitata, l'agente può visualizzare il messaggio utente mentre viene digitato, anche prima dell'invio del messaggio da parte dell'utente. In caso contrario, `...` viene inviato all'agente.	No	`false`
`enableAttachment`	Configura la condivisione degli allegati nell'applicazione chat.	No	`true`
`enableAttachmentSecurity`	Quando l'impostazione è `true`, alle richieste di caricamento degli allegati vengono passate intestazioni aggiuntive per assicurarsi che non possano essere scaricate senza passare un token JWT firmato valido come intestazione di autorizzazione. Nota: non abilitare questa impostazione se la competenza si connette a un'istanza ODA versione 20.08 o viene eseguita su una versione precedente alla 20.08. Questa proprietà si applica solo alle connessioni abilitate per l'autenticazione del client alle versioni 20.12 e successive della piattaforma ODA.	No	`false`
`enableAutoSendSpeechResponse`	Quando è impostato su `true` (impostazione predefinita), la risposta vocale dell'utente viene inviata automaticamente al server della chat e viene visualizzata come messaggio inviato nella finestra della chat. Quando è impostata su `false`, la risposta vocale dell'utente viene visualizzata nel campo di testo del messaggio prima dell'invio al server della chat, consentendo all'utente di modificarla prima di inviarla manualmente o di eliminare il messaggio.	No	`true`
`enableClearMessage`	Abilita il pulsante Cancella messaggio nell'intestazione del widget chat.	No	`false`
`enableDefaultClientResponse`	Se l'impostazione è `true`, il client visualizza le risposte predefinite quando la risposta dello skill è stata ritardata o quando non è presente alcuna risposta dallo skill.	No	`false`
`enableEndConversation`	Consente all'utente di terminare la conversazione e reimpostare la sessione di chat. Cancella inoltre la cronologia delle conversazioni locali, si disconnette dal server di chat e riduce al minimo il widget.	No	`true`
`enableSendTypingStatus`	Controlla l'invio dello stato di digitazione dell'utente.	No	`false`
`enableSpeechRecognition`	Abilita il pulsante del microfono.	No	`false`
`enableSpeechSynthesis`	Consente di leggere ad alta voce le risposte agli skill. Se si imposta questo flag su `true`, è possibile abilitare la lettura ad alta voce delle risposte dello skill mediante l'API Swift.	No	`false`
`enableTimestamp`	Abilita l'indicatore orario per i messaggi. È possibile impostare la modalità di visualizzazione dell'indicatore orario come assoluta o relativa utilizzando l'impostazione `timestampMode`.	No	`true`
`headerLogo`	Passa un oggetto `UIImage`, posizionato nell'intestazione. L'allineamento predefinito si trova sul lato sinistro dell'intestazione. Per posizionarla sulla destra, impostare la proprietà `headerLogoAlignment` su `NSTextAlignment.right`.	No	N/A
`headerLogoAlignment`	Imposta l'allineamento del logo dell'intestazione, se passato.	No	`NSTextAlignment.left`
`initSpeechSynthesisMuted`	Imposta lo stato predefinito di `BotAudioResponse` come disattivato o disattivato.	No	`true`
`initUserHiddenMessage`	Messaggio di testo utente utilizzato per avviare una conversazione. Questo messaggio, che viene inviato quando il widget di chat è pronto, non viene effettivamente visualizzato nella chat.	No	N/A
`initUserProfile`	Inizializza il profilo utente prima dell'inizio della conversazione. Il formato del payload del profilo deve essere `["profile": […] ]`. Ad esempio: `initUserProfile = ["profile": ["givenName": "First", "surname": "Last", "email": "first.last@example.com", "properties": ["lastOrderedItems": "1 medium pepperoni"]]]` Questa funzione aggiorna il contesto utente prima che il messaggio iniziale "nascosto" venga inviato da `initUserHiddenMessage` per avviare la conversazione. Di conseguenza, il profilo utente può essere riportato nel primo messaggio di risposta all'utente. Ad esempio, lo skill può salutare l'utente con un messaggio del tipo "Benvenuto, John Smith! Il tuo ultimo ordine era una pizza al peperoncino medio".	No	N/A
`multiLangChat`	Consente al widget chat di rilevare la lingua di un utente e di selezionare una lingua preferita da un menu a discesa nell'intestazione per la conversazione.
`reconnectMaxAttempts`	Il numero di tentativi effettuati dal widget chat per riconnettersi quando la connessione iniziale non riesce.	No	5
`sharePopupConfiguration`	Consente all'utente di scegliere le opzioni disponibili come parte del menu allegato. Il valore predefinito è impostato su un elenco di tutte le opzioni.	No	`[.photoAndVideoLibrary, .files, .camera]`
`showConnectionStatus`	Consente la visualizzazione dello stato della connessione nell'intestazione del widget chat.	No	`false`
`showTypingStatus`	Visualizza l'indicatore di digitazione in attesa della risposta dello skill.	No	`true`
`speechLocale`	Impostazioni nazionali previste del discorso dell'utente utilizzate per il riconoscimento vocale. La lingua predefinita è l'inglese (`'en-US'`) degli Stati Uniti. Le altre versioni locali supportate sono: inglese australiano (`'en-au'`), inglese britannico (`'en-uk'`), francese (`'fr-fr'`), tedesco (`'de-de'`), italiano (`'it-it'`), portoghese brasiliano (`'pt-br'`) e spagnolo (`'es-es'`). Le impostazioni nazionali di sintesi vocale possono essere impostate in modo dinamico chiamando l'API `setSpeechLocale('<locale>')`. Il riconoscimento vocale non funzionerà se sono state passate impostazioni nazionali non supportate.	No	`en-us`
`speechSynthesisVoicePreferences`	Corrisponde alle preferenze fornite in base sia alla lingua-locale che al nome vocale. Se non viene trovata alcuna corrispondenza, viene utilizzata la voce predefinita per la lingua-locale specificata. In quest'ultimo caso, l'API Apple trova la migliore corrispondenza con la lingua-locale specificata.	No	N/A
`timestampFormat`	Formatta l'indicatore orario di consegna che accompagna i messaggi. Il formato dell'indicatore orario deve essere supportato da Swift DateFormatter.	No	`E MMM d, HH:mm a`
`timestampMode`	Se si abilitano gli indicatori orari impostando `enableTimestamp` su `true`, è possibile utilizzare l'impostazione della modalità indicatore orario come indicatore orario assoluto visualizzato in ogni messaggio oppure come indicatore orario relativo visualizzato solo nel messaggio più recente. `TimestampMode.default`: imposta un indicatore orario assoluto su ogni messaggio. `TimestampMode.relative`: l'indicatore orario viene visualizzato prima del primo messaggio del giorno come indicatore orario assoluto in un'intestazione e quindi come indicatore orario relativo per i nuovi messaggi come indicatore orario di aggiornamento che indica il tempo trascorso dall'aggiunta del messaggio nella conversazione. L'indicatore orario relativo viene aggiornato a intervalli prestabiliti fino alla ricezione di un nuovo messaggio.	No	`TimestampMode.relative`
`title`	Imposta il titolo dell'applicazione, visualizzato nella barra delle applicazioni.	No	N/A
`ttsService`	Istanza di tipo `TTSService` utilizzata per l'inserimento di un servizio TTS (Text-to- Speech). Applicabile solo se `enableSpeechSynthesis` è impostato su `true`.	No
`typingStatusInterval`	Intervallo, in secondi, per limitare l'evento di digitazione e l'invio dello stato di digitazione.	No	`3`
`typingStatusTimeout`	Imposta il timeout, in secondi, per nascondere l'indicatore di stato di digitazione quando non è stata ricevuta alcuna risposta dal server chat.	No	`30 secs`

Strings

Configurare le stringhe aggiungendo le seguenti coppie chiave/valore nel file <language-code>.iproj/Localizable.strings dell'applicazione.

Chiave	descrizione;	Valore predefinito
`connectionFailureMessage`	Il messaggio visualizzato dopo l'esaurimento del numero di tentativi impostato da `reconnectMaxAttempts`.	`Sorry, the assistant is unavailable right now. If the issue persists, contact your help desk.`
`connectionRetryLabel`	La stringa predefinita per il pulsante Nuovo tentativo visualizzato con `connectionFailureMessage`.	`Try Again`
`end_conversation_action_yes`	Testo del pulsante di conferma nel prompt di conferma della sessione finale.	`Yes`
`end_conversation_alert_message`	Il corpo del messaggio del prompt di conferma della conversazione finale.	`This will also clear your conversation history`
`end_conversation_alert_no`	Testo del pulsante Rifiuta nel prompt di conferma della sessione finale.	`No`
`end_conversation_alert_title`	Titolo del prompt di conferma della fine conversazione.	`Are you sure you want to end the conversation?`
`odais_access_label_audio_attachment`	Etichetta di accesso facilitato per un messaggio allegato audio	`audio attachment`
`odais_access_label_button_attach`	Etichetta di accesso facilitato per il pulsante Carica allegato.	`Upload attachment`
`odais_access_label_button_audio_reponse_off`	L'etichetta di accesso facilitato per il pulsante Volume con audio disattivato	`Unmute audio response`
`odais_access_label_button_audio_reponse_on`	L'etichetta di accessibilità per il pulsante per il volume senza audio.	`Mute audio response`
`odais_access_label_button_back`	Etichetta di accessibilità per il pulsante Indietro.	`Go back`
`odais_access_label_button_card_navigation_left`	Etichetta di accesso facilitato per il pulsante di navigazione a sinistra per la vista della scheda orizzontale.	`Card navigation right`
`odais_access_label_button_card_navigation_right`	Etichetta di accesso facilitato per il pulsante di navigazione a destra per la vista della scheda orizzontale.	`Card navigation left`
`odais_access_label_button_clear`	Etichetta di accesso per il pulsante Cancella messaggio	`Clear messages`
`odais_access_label_button_keyboard`	L'etichetta di accessibilità per il pulsante con tastiera.	`Enter message`
`odais_access_label_button_overflow`	L'etichetta di accessibilità per un pulsante del menu di overflow.	`Open Menu`
`odais_access_label_button_select_language`	`The accessibility label for select language button.`	`Select Language`
`odais_access_label_button_send`	L'etichetta di accesso facilitato per il pulsante di invio	`Send message`
`odais_access_label_button_speak`	L'etichetta di accesso facilitato per il pulsante microfono	`Speak message`
`odais_access_label_card_desc`	Etichetta di accesso facilitato per la descrizione di una scheda seguita dal testo	`card description`
`odais_access_label_card_title`	Etichetta di accesso facilitato per il titolo di una scheda seguita dal testo	`card title`
`odais_access_label_chat_status`	Etichetta di accesso facilitato per lo stato della chat seguita dalla stringa di stato	`Chat status`
`odais_access_label_chat_title`	Etichetta di accesso facilitato per il titolo della chat seguita dalla stringa del titolo della chat	`Chat title`
`odais_access_label_file_attachment`	Etichetta di accesso facilitato per un messaggio allegato file	`file attachment`
`odais_access_label_footer_text`	Etichetta di accesso facilitato per un testo del piè di pagina seguito dal testo	`footer text`
`odais_access_label_header_text`	Etichetta di accesso facilitato per un testo di intestazione seguito dal testo	`header text`
`odais_access_label_image_attachment`	Etichetta di accesso facilitato per un messaggio allegato immagine	`image attacment`
`odais_access_label_location_message`	Etichetta di accesso facilitato per un messaggio di posizione seguito dal titolo del messaggio di posizione, dalla latitudine e dalla longitudine	`location message`
`odais_access_label_pause`	L'etichetta di accesso facilitato per il pulsante di pausa.	`Pause`
`odais_access_label_play`	L'etichetta di accesso facilitato per il pulsante di riproduzione	`Play`
`odais_access_label_skill`	Etichetta di accesso facilitato per un payload del messaggio di skill letta da VoiceOver (la funzione di accesso facilitato iOS). Questa etichetta viene quindi aggiunta all'etichetta specifica del messaggio.	`Skill`
`odais_access_label_text_message`	Etichetta di accesso facilitato per un messaggio di testo seguito dal testo	`text message`
`odais_access_label_user`	Etichetta di accesso facilitato per un payload del messaggio utente letta da VoiceOver (la funzione di accesso facilitato iOS). Questa etichetta viene quindi aggiunta all'etichetta specifica del messaggio.	`User`
`odais_access_label_video_attachment`	Etichetta di accesso facilitato per un messaggio allegato video	`video attachment`
`odais_access_label_webview_clear_button`	L'etichetta di accesso facilitato per il pulsante Cancella WebView nella vista Web del widget.	`Close webview`
`odais_access_label_webview_title`	Etichetta di accesso facilitato predefinita per il titolo della vista Web nel widget.	`Webview title`
`odais_alert`	Il titolo del messaggio di avviso visualizzato per gli errori di sintesi vocale e di file.	`Alert`
`odais_camera`	Il testo dell'azione visualizzato nel popup allegato per l'utilizzo della fotocamera del dispositivo.	`Camera`
`odais_camera_permission_denied`	Messaggio di errore visualizzato quando l'accesso alla fotocamera non è consentito.	`Camera permission denied.`
`odais_chat_title`	Il titolo dell'applicazione visualizzata nella barra delle applicazioni.	`Digital Assistant`
`odais_check_url`	Messaggio di errore visualizzato per un collegamento interrotto nella vista Web.	`Please check the url!`
`odais_clear_chat`	Il titolo del pulsante Cancella chat nel menu di overflow.	`Clear Chat`
`odais_connected`	Testo di stato visualizzato quando è stata stabilita la connessione tra il widget chat e il server chat Oracle.	`Connected`
`odais_connecting`	Il testo di stato visualizzato mentre il widget chat si connette al server chat Oracle.	`Connecting`
`odais_default_greeting_message`	Risposta di saluto predefinita.	`Hey, Nice to meet you! Allow me a moment to get back to you.`
`odais_default_sorry_message`	La risposta predefinita alla scadenza del tempo di attesa per il messaggio.	`I'm sorry. I can't get you the right content. Please try again.`
`odais_default_wait_message`	Risposta predefinita visualizzata durante l'attesa del messaggio relativo allo skill.	`I'm still working on your request. Thank you for your patience!`
`odais_disconnected`	Testo di stato visualizzato quando la connessione tra la vista chat e il server di chat Oracle è stata chiusa.	`Disconnected`
`odais_done`	Testo dell'etichetta del pulsante che chiude la vista chat.	`Done`
`odais_download_attachment_folder`	Nome della cartella creata all'interno della cartella delle applicazioni per il salvataggio degli allegati. Il valore predefinito è una stringa vuota.	Una stringa vuota.
`odais_error`	Titolo dei messaggi di errore e di avviso relativi alla vista Web.	`Error`
`odais_fail_to_load`	Messaggio di errore visualizzato quando la pagina non può essere caricata nella vista Web. Il testo all'interno delle parentesi graffe (`{}`) verrà collegato al collegamento da aprire nel browser predefinito.	`Sorry, we can't open this page in the chat window. Click {here} to open it in your browser.`
`odais_file_not_supported`	Messaggio di avviso visualizzato quando l'utente seleziona un tipo di file non supportato per gli allegati.	`File type not supported`
`odais_file_size_warning`	Il messaggio di avviso visualizzato quando il file scelto per l'allegato supera il limite massimo di dimensioni dell'allegato. Il testo `{0}` viene sostituito dal limite massimo di dimensioni degli allegati impostato. Il limite massimo predefinito per la dimensione degli allegati è 25 MB.	`You can only attach files of size up to {0}MB.`
`odais_files`	Il testo dell'azione visualizzato nel popup allegato per la scelta di un file dalla memoria.	`Files`
`odais_gallery_permission_denied`	Messaggio di avviso visualizzato quando non è stata concessa l'autorizzazione per la galleria.	`You don't have permission to access gallery.`
`odais_language_ar`	Stringa predefinita per la visualizzazione della lingua araba nel menu a discesa, se non diversamente specificato.	`Arabic`
`odais_language_de`	Salvo disposizione contraria, la stringa predefinita per la visualizzazione della lingua tedesca nel menu a discesa.	`German`
`odais_language_detect`	Stringa predefinita per la visualizzazione di Detect Language nel menu a discesa, a meno che non sia indicato diversamente.	`Detect Language`
`odais_language_en`	La stringa predefinita per la visualizzazione della lingua inglese nel menu a discesa, se non diversamente specificato.	`English`
`odais_language_es`	La stringa predefinita per la visualizzazione della lingua spagnola nel menu a discesa, se non diversamente specificato.	`Spanish`
`odais_language_fr`	La stringa predefinita per la visualizzazione della lingua francese nel menu a discesa, se non diversamente specificato.	`French`
`odais_language_it`	La stringa predefinita per la visualizzazione della lingua italiana nel menu a discesa, se non diversamente specificato.	`Italian`
`odais_language_nl`	La stringa predefinita per la visualizzazione della lingua olandese nel menu a discesa, se non diversamente specificato.	`Dutch`
`odais_language_pt`	La stringa predefinita per la visualizzazione della lingua portoghese nel menu a discesa, se non diversamente specificato.	`Portuguese`
`odais_location_disabled`	Il messaggio di errore visualizzato quando i servizi di posizione sono disabilitati.	`Location services not enabled. Please enable the Location Services switch in Settings > Privacy.`
`odais_location_fetch_error`	Il messaggio di errore visualizzato quando il kit SDK non è in grado di recuperare la posizione del dispositivo corrente.	`Error in getting device location. Please check location settings or try again.`
`odais_location_permission_denied`	Messaggio di errore visualizzato quando l'accesso alla posizione non è consentito.	`Location Permission Denied.`
`odais_mute`	Titolo del pulsante Disattiva audio nel menu di overflow.	`Mute`
`odais_no_speech_error`	Messaggio di avviso visualizzato quando al server di sintesi vocale non viene inviato alcun contenuto audio (l'utente non ha parlato).	`Could not detect the voice, no message sent.`
`odais_notification_title`	Il titolo visualizzato nella barra delle notifiche.	`OracleChatBot`
`odais_ok`	Testo dell'etichetta del pulsante che chiude i messaggi di avviso e di errore.	`Ok`
`odais_photo`	Testo azione visualizzato nel popup allegato per la scelta di un file dalla galleria del telefono.	`Photo & Video Library`
`odais_select_language`	Titolo del pulsante Seleziona lingua nel menu di overflow.	`Select Language`
`odais_speak_your_message`	Testo segnaposto per il campo di input del messaggio utente in modalità di sintesi vocale	`Start speaking`
`odais_speech_cancel`	Il testo dell'etichetta del pulsante sul popup vocale per annullare l'invio dell'audio registrato al server di sintesi vocale.	`CANCEL`
`odais_speech_error`	Messaggio di avviso visualizzato quando non è possibile registrare l'audio.	`Error in voice recognition. Please try again later.`
`odais_speech_permission_denied`	Messaggio di errore visualizzato quando non è consentito l'utilizzo del microfono.	`Permission_Denied`
`odais_speech_start`	Il testo visualizzato nel popup di sintesi vocale che indica che l'utente può iniziare a parlare.	`Listening...`
`odais_speech_unsupported_locale`	Il messaggio di errore visualizzato quando le impostazioni nazionali di sintesi vocale impostate non sono supportate dal server di sintesi vocale.	`The set speech locale is not supported. Cannot start recording.`
`odais_stars_rating`	Messaggio letto ad alta voce quando l'utente fa clic su un pulsante di feedback in modalità di accesso facilitato	`Rate {0} star`
`odais_subtitle`	Sottotitolo del widget di chat visualizzato sotto il titolo nell'intestazione. Se `showConnectionStatus` è impostato su `true` e anche il sottotitolo è impostato, il sottotitolo viene visualizzato al posto dello stato della connessione.	N/A
`odais_timestamp_days`	L'indicatore orario relativo visualizzato ogni giorno dalla ricezione del messaggio precedente. `{0}` viene sostituito dal numero di giorni trascorsi.	`{0}d ago`
`odais_timestamp_hours`	L'indicatore orario relativo che viene visualizzato ogni ora per le prime 24 ore dopo la ricezione del messaggio precedente. `{0}` viene sostituito dal numero di ore trascorse.	`{0}hr ago`
`odais_timestamp_minutes`	L'indicatore orario relativo visualizzato ogni minuto dalla ricezione dell'ultimo messaggio. `{0}` viene sostituito dal numero di minuti trascorsi.	`{0}min ago`
`odais_timestamp_months`	L'indicatore orario relativo visualizzato ogni mese dalla ricezione del messaggio precedente. `{0}` viene sostituito dal numero di mesi trascorsi.	`{0}mth ago`
`odais_timestamp_now`	L'indicatore orario relativo visualizzato per un nuovo messaggio.	`Now`
`odais_timestamp_seconds`	L'indicatore orario relativo visualizzato dieci secondi dopo la ricezione del messaggio e prima che siano trascorsi 60 secondi dalla ricezione dell'ultimo messaggio.	`A few seconds ago`
`odais_timestamp_years`	L'indicatore orario relativo visualizzato ogni anno dopo la ricezione del messaggio precedente. `{0}` viene sostituito dal numero di anni trascorsi.	`{0}yr ago`
`odais_too_much_speech_error`	Il messaggio di avviso visualizzato quando un numero eccessivo di contenuti audio viene inviato al server di sintesi vocale contemporaneamente (l'utente parla troppo).	`Too much voice input to recognize. Cannot generate recognized text.`
`odais_type_your_message`	Testo segnaposto per il campo di input del messaggio utente	`Enter message`
`odais_unmute`	Titolo del pulsante di disattivazione audio nel menu di overflow.	`Unmute`
`odais_upload_attachment`	Il testo visualizzato nella bolla che indica che è in corso il caricamento di un allegato.	`Uploading attachment`
`odais_upload_attachment_error`	Messaggio di errore visualizzato quando non è possibile caricare un allegato.	`Error in uploading attachment`
`odais_zero_byte_file_warning`	Il messaggio di avviso visualizzato quando il file selezionato ha zero (0) byte.	`Files of size zero bytes can not be uploaded.`
`editFieldErrorMessage`	Messaggio di errore a livello di campo visualizzato quando il valore immesso dall'utente non è valido per tale campo. L'SDK assume per impostazione predefinita questo messaggio quando la competenza non fornisce un messaggio di errore client.	`Field Input is invalid`
`editFormErrorMessage`	Messaggio di errore a livello di modulo visualizzato sotto l'azione di sottomissione del modulo per la convalida lato client. Questo messaggio viene visualizzato quando almeno uno dei campi non è valido ed è presente più di un campo. L'SDK utilizza per impostazione predefinita questo messaggio quando lo skill non fornisce un messaggio di errore nel payload del messaggio.	`Some of the fields need your attention.`
`noResultText`	Testo di stato visualizzato quando non sono presenti corrispondenze da una ricerca utente nella vista elenco a selezione multipla.	`No more results`

Proprietà e colori UI

È possibile modificare i colori per i seguenti componenti utilizzando BotsProperties.<component name> = <UIColor type>. Come descritto in Iniziare l'SDK nell'applicazione, è necessario impostare tutti i colori in BotsProperties prima di aggiungere la vista chat al controller vista.

Componente	descrizione;	Valori
`ActionBorderColor`	Colore del bordo per un pulsante di azione	`161513.withAlphaComponent(0.50)`
`ActionButtonColor`	Colore per un pulsante di azione	`UIColor.clear`
`ActionLabelTextColor`	Colore del testo per un'etichetta di azione	`#161513`
`AgentAvatarBackgroundColor`	Colore di sfondo del layout dell'avatar quando l'avatar dell'agente non è stato fornito e le iniziali del nome dell'agente vengono visualizzate al suo posto	`#A890B6`
`AgentAvatarTextColor`	Colore del testo delle iniziali del nome dell'agente visualizzate all'interno del layout dell'avatar dell'agente.	`UIColor.white`
`AgentNameTextColor`	Colore del testo utilizzato per il nome dell'agente che viene visualizzato sopra i messaggi dell'agente.	`#161513.withAlphaComponent(0.65)`
`AttachmentBackgroundColor`	Il colore di sfondo dei messaggi allegati.	`UIColor.white`
`AttachmentBorderColor`	Il colore di sfondo dei messaggi allegati.	`#161513`
`AttachmentIconColor`	Colore delle icone nei messaggi allegato.	`#161513`
`AttachmentTextColor`	Colore del testo dei messaggi allegati.	`#161513`
`BotMessageColor`	Colore di sfondo per i messaggi di testo, allegato e posizione inviati dallo skill	`UIColor.white`
`BotTextColor`	Il colore del testo in un messaggio di testo inviato dallo skill	`#161513`
`CardActionBorderColor`	Colore dell'ordine di un pulsante di azione carta	`#161513.withAlphaComponent(0.50)`
`CardActionButtonColor`	Colore di un pulsante di azione carta	`UIColor.clear`
`CardActionLabelTextColor`	Colore del testo di un'etichetta di azione scheda	`UIColor.white`
`CardBackgroundColor`	Colore dello sfondo per una scheda	`UIColor.white`
`CardDescriptionTextColor`	Colore del testo per la descrizione di una carta	`#161513`
`CardNavigationArrowColor`	Colore delle frecce del pulsante di navigazione in una vista a schede orizzontale	`#161513`
`CardNavigationButtonColor`	Colore dei pulsanti di navigazione nella vista a schede orizzontale	`#FBF9F8`
`CardTitleTextColor`	Il colore del testo per il titolo di una carta	`#161513`
`ChatBackgroundColor`	Colore dello sfondo della vista chat	`#F5F4F2`
`conversationBeginPosition`	Imposta il punto di partenza della conversazione nella parte superiore o inferiore.	I valori sono `top` e `bottom`. L'impostazione predefinita è `bottom`.
`EnableArrowsForHorizontalCards`	Abilita le frecce di navigazione per la vista scheda orizzontale se impostata su `true`. Disabilita l'impostazione su `false`.	`false`
`FooterColor`	Il colore di sfondo del piè di pagina.	`UIColor.white`
`FooterIconsColor`	Colore delle icone di allegato, invio e microfono presenti nel piè di pagina.	`#161513`
`FooterInlineIconsColor`	Il colore delle icone (se presenti) all'interno del campo di immissione del testo	`#004C8C`
`GlobalActionBorderColor`	Colore del bordo di un pulsante di azione globale	`#161513.withAlphaComponent(0.50)`
`GlobalActionButtonColor`	Colore del pulsante di azione globale	`#0077C2`
`GlobalActionLabelTextColor`	Colore di un'etichetta azione globale	`#161513`
`HeaderColor`	Il colore di sfondo dell'intestazione	`#F1EFED`
`HeaderIconsColor`	Colore per le icone di cancellazione del messaggio, del volume e dell'intestazione mute.	`#161513`
`HeaderTextColor`	Colore del testo per lo stato della connessione, lo stato di digitazione e le voci di intestazione del titolo della chat	`#161513`
`InputFieldColor`	Colore di sfondo del campo di input di testo	`#161513`
`InputFieldTextColor`	Colore del testo nel campo di input di testo	`#161513`
`IsRTL`	Quando è impostato su `true`, inoltra l'interfaccia utente per supportare il layout per le lingue da destra a sinistra, ad esempio l'arabo. Se impostato su `false`, il layout predefinito dell'interfaccia utente per le lingue da sinistra a destra (ad esempio, l'inglese).	`false`
`LinkHandler`	Imposta la modalità di apertura dei collegamenti visualizzati nel widget chat nell'ambito di qualsiasi payload di messaggi. I valori possibili sono `LinkHandlerType.browser` e `LinkHandlerType.webview.` È possibile eseguire l'override di questo comportamento per azioni URL specifiche utilizzando il delegato `beforeDisplay()` modificando il tipo di azione da `url` a `webview`.	`LinkHandlerType.browser`
`PopupBackgroundColor`	Colore di sfondo delle viste popup.	`UIColor.white`
`PopupIconColor`	Colore delle icone nelle viste popup.	`#161513`
`PopupTextColor`	Colore del testo nelle viste popup.	`#161513`
`RatingStarColor`	Colore di un pulsante di feedback prima che l'utente lo abbia selezionato.	`UIColor.white`
`RatingStarColorFill`	Colore di un pulsante di feedback dopo che è stato selezionato dall'utente.	`#0077C2`
`saveClickedImagesInGallery`	Quando l'opzione è impostata su `true` (impostazione predefinita), le immagini acquisite dall'applicazione Fotocamera iPhone dagli utenti skill vengono salvate nella raccolta e caricate direttamente nella competenza come allegato. Se queste immagini non devono essere salvate nella galleria, impostare questo flag su `false`.	`true`
`SpeechVisualizationColor`	Colore delle barre di visualizzazione del parlato	`#161513`
`SpeechVisualizerContainerBackground`	Colore dello sfondo della vista Visualizzazione vocale	`UIColor.white`
`Theme`	Il tema dell'interfaccia utente per l'applicazione. I valori validi sono `BotUITheme.REDWOOD_DARK` e `BotUITheme.DEFAULT`. Per il tema `REDWOOD_DARK`, è consigliabile `#201E1C`. Per il tema `DEFAULT`, è `#004C8C`. Imposta il colore della barra di navigazione utilizzando l'app di esempio.	`BotUITheme.DEFAULT`
`TimestampColor`	Il colore per l'indicatore orario del messaggio	`#161513.withAlphaComponent(0.65)`
`UserMessageColor`	Colore di sfondo per un messaggio utente	`#E4E1DD`
`UserTextColor`	Il colore del testo in un utente di testo inviato dall'utente	`#161513`
`WebViewConfig`	Istanza della struttura `WebViewConfiguration` con tutti i campi impostati sui relativi valori predefiniti.	Imposta le impostazioni di configurazione per la vista Web.

Icone

È possibile personalizzare le seguenti icone impostando il nome dell'asset immagine dell'icona nell'applicazione client.

Icona	Nome asset immagine
Avatar agente	`"agentAvatar"`
Pulsante Allegato	`"attachmentButton"`
Avatar competenza	`"botAvatar"`
Pulsante Cancella	`"clearButton"`
Pulsante Chiudi per richiamare il flusso di fine conversazione	`"closeButton"`
Scarica	`"downloadAttachmentButton"`
Icona file per un allegato file	`"file"`
Pulsante con la tastiera	`"keyboardButton"`
Freccia sinistra per schede orizzontali	`"leftArrow"`
Pulsante Mic	`"micButton"`
Avatar persona	`"personAvatar"`
Icona Valutazione utilizzata per i pulsanti del componente feedback	`"ratingIcon"`
Freccia destra per schede orizzontali	`"rightArrow"`
Pulsante Invia	`"sendButton"`
Pulsante che consente di richiamare il popup di selezione della lingua	`"selectLanguageButton"`
Pulsante del menu di overflow quando nell'intestazione sono presenti tre o più pulsanti di azione.	`"overflowButton"`
Pulsante Volume disattivato	`"volumeOffButton"`
Pulsante Volume attivato	`"volumeOnButton"`
Zoom	`"imageZoomButton"`

Documentazione di Oracle Cloud Infrastructure