Riferimento API

Preferenze

Configurazione dell’applicazione. La lettura completa delle preferenze richiede la modalità sviluppatore; letture mirate e scritture seguono le politiche delle chiavi registrate di seguito.

Chiavi delle preferenze registrate (63)

L’accesso segue la politica di ogni chiave. La lettura di tutti i valori grezzi richiede la modalità sviluppatore.

ChiaveUtilizzoAccesso
dlnaEnable the DLNA service. Lettura/scrittura locale e remota
device_nameDevice display name. Lettura/scrittura locale e remota
feed_auto_refreshEnable automatic feed refresh. Lettura/scrittura locale e remota
feed_auto_refresh_intervalAutomatic feed refresh interval in seconds. Lettura/scrittura locale e remota
feed_auto_refresh_only_wifiRestrict automatic feed refresh to Wi-Fi. Lettura/scrittura locale e remota
ai_image_search_enabledEnable semantic image search. Lettura/scrittura locale e remota
ai_image_search_modelSelected image-search model. Lettura/scrittura locale e remota
dlna_allowed_sendersAllowed DLNA sender identities. Lettura/scrittura locale e remota
dlna_denied_sendersDenied DLNA sender identities. Lettura/scrittura locale e remota
dark_themeTheme selection: USE_DEVICE_THEME, ON or OFF. Lettura/scrittura locale e remota
amoled_dark_themeUse the AMOLED dark-theme option. Lettura/scrittura locale e remota
pdf_follow_dark_themeApply the current dark theme to PDF viewing. Lettura/scrittura locale e remota
localeInterface language. Lettura/scrittura locale e remota
show_hidden_filesShow hidden files in file browsing. Lettura/scrittura locale e remota
feed_font_scaleFeed-reader font scale. Lettura/scrittura locale e remota
editor_wrap_contentWrap long editor lines. Lettura/scrittura locale e remota
editor_font_sizeEditor font size. Lettura/scrittura locale e remota
editor_status_barShow the editor status bar. Lettura/scrittura locale e remota
desktop_home_featuresFeatures displayed on the desktop home page. Lettura/scrittura locale e remota
desktop_rail_featuresFunzioni mostrate nella barra di navigazione desktop. Lettura/scrittura locale e remota
media_excluded_dirsDirectories hidden from media pages; file indexing and file search remain available. Lettura/scrittura locale e remota
desktop_upload_dirsPercorsi delle cartelle di caricamento salvati per categoria multimediale desktop. Lettura/scrittura locale e remota
audio_sort_byAudio-library sort order. Lettura/scrittura locale e remota
video_sort_byVideo-library sort order. Lettura/scrittura locale e remota
image_sort_byImage-library sort order. Lettura/scrittura locale e remota
doc_sort_byDocument-library sort order. Lettura/scrittura locale e remota
file_sort_byFile-browser sort order. Lettura/scrittura locale e remota
pkg_sort_byInstalled-package sort order. Lettura/scrittura locale e remota
audio_play_modeAudio playback repeat or shuffle mode. Lettura/scrittura locale e remota
audio_playback_speedAudio playback speed multiplier. Lettura/scrittura locale e remota
pomodoro_settingsPomodoro work, break and round configuration. Lettura/scrittura locale e remota
screen_mirror_qualityScreen-mirror quality preset. Lettura/scrittura locale e remota
clipboard_directionsClipboard synchronization direction for each peer. Solo lettura/scrittura locale
http_portHTTP listener port. Solo lettura/scrittura locale
https_portHTTPS listener port. Solo lettura/scrittura locale
background_service_enabledEnable the background service. Solo lettura/scrittura locale
remote_accessEnable remote access. Solo lettura/scrittura locale
developer_modeEnable developer tools and full preference or database access. Solo lettura/scrittura locale
allow_any_hostAllow requests with arbitrary HTTP host names. Solo lettura/scrittura locale
nearby_discoverableAllow nearby devices to discover this device. Solo lettura/scrittura locale
notification_filterNotification synchronization filter configuration. Solo lettura/scrittura locale
launcher_shortcutsConfigured launcher shortcuts. Solo lettura/scrittura locale
image_grid_cells_per_rowImage-grid column count. Solo lettura/scrittura locale
video_grid_cells_per_rowVideo-grid column count. Solo lettura/scrittura locale
httpsEnable HTTPS. Solo lettura/scrittura locale
web_address_bar_expandedExpand the remote-access address bar. Solo lettura/scrittura locale
passwordLocal password configuration. Solo lettura/scrittura locale
password_typeSelected password mode. Solo lettura/scrittura locale
login_require_approvalRequire local approval for remote login. Solo lettura/scrittura locale
api_permissionsFeatures authorized for remote API clients. Solo lettura/scrittura locale
dev_tokenDevelopment access token configuration. Solo lettura/scrittura locale
log_levelApplication logging level. Solo lettura/scrittura locale
auto_check_updateAutomatically check for application updates. Solo lettura/scrittura locale
skip_versionApplication update version to skip. Solo lettura/scrittura locale
mdns_hostnamemDNS hostname used for local discovery. Locale o remoto autenticato con HTTP_SERVER
recent_selected_dirsFino a otto percorsi assoluti di cartelle confermate su questo dispositivo, dal più recente. In Windows si usa /; la radice è D:/, non D:. ["D:/Projects/Photos", "E:/Backup/Photos"]In locale o da remoto con accesso autenticato ai file
app_home_featuresFeatures displayed by the native Tools page and its remote projection. Lettura/scrittura locale; sola lettura remota
opaque_server_setupInternal OPAQUE password-authentication server setup. Solo uso interno di Rust
opaque_password_recordInternal OPAQUE password registration record. Solo uso interno di Rust
client_idInternal persistent device identity. Solo uso interno di Rust
adb_tokenInternal authorization token for local command access. Solo uso interno di Rust
master_secretInternal master secret. Solo uso interno di Rust
signature_key_pairInternal device signing key pair. Solo uso interno di Rust

Definizioni di tipo

graphql
type Subscription {
  prefsChanged: Boolean!
}

type Mutation {
  removePref(key: String!): Boolean!
  setPref(key: String!, value: JSON!): Boolean!
}

type Query {
  prefs(keys: [String!]): JSON!
}

scalar JSON

Operazioni

subscription

prefsChanged

Ricevere un segnale quando cambiano le preferenze; rileggere i campi di configurazione utilizzati.

graphql
subscription prefsChanged {
  prefsChanged
}
mutation

removePref

Rimuovere una sostituzione di preferenza scrivibile; auto_check_update e skip_version tornano ai valori predefiniti. Consultare l’elenco delle chiavi consentite.

graphql
mutation removePref($key: String!) {
  removePref(key: $key)
}
mutation

setPref

Impostare una preferenza registrata scrivibile, convalidarne il valore e applicarne gli effetti. Consultare l’elenco delle chiavi consentite per le autorizzazioni.

graphql
mutation setPref($key: String!, $value: JSON!) {
  setPref(key: $key, value: $value)
}
query

prefs

Omettere keys o passare null per leggere tutte le preferenze grezze memorizzate, incluse le chiavi interne; è richiesta la modalità sviluppatore. Le chiavi specificate usano l’elenco consentito; un elenco vuoto restituisce un oggetto vuoto.

graphql
query prefs($keys: [String!]) {
  prefs(keys: $keys)
}