Referencia de la API

Preferencias

Configuración de la aplicación. Leer todas las preferencias requiere el modo de desarrollador; las lecturas selectivas y escrituras siguen las políticas de claves registradas a continuación.

Claves de preferencias registradas (63)

El acceso sigue la política de cada clave. Leer todos los valores sin procesar requiere el modo de desarrollador.

ClaveUsoAcceso
dlnaEnable the DLNA service. Lectura/escritura local y remota
device_nameDevice display name. Lectura/escritura local y remota
feed_auto_refreshEnable automatic feed refresh. Lectura/escritura local y remota
feed_auto_refresh_intervalAutomatic feed refresh interval in seconds. Lectura/escritura local y remota
feed_auto_refresh_only_wifiRestrict automatic feed refresh to Wi-Fi. Lectura/escritura local y remota
ai_image_search_enabledEnable semantic image search. Lectura/escritura local y remota
ai_image_search_modelSelected image-search model. Lectura/escritura local y remota
dlna_allowed_sendersAllowed DLNA sender identities. Lectura/escritura local y remota
dlna_denied_sendersDenied DLNA sender identities. Lectura/escritura local y remota
dark_themeTheme selection: USE_DEVICE_THEME, ON or OFF. Lectura/escritura local y remota
amoled_dark_themeUse the AMOLED dark-theme option. Lectura/escritura local y remota
pdf_follow_dark_themeApply the current dark theme to PDF viewing. Lectura/escritura local y remota
localeInterface language. Lectura/escritura local y remota
show_hidden_filesShow hidden files in file browsing. Lectura/escritura local y remota
feed_font_scaleFeed-reader font scale. Lectura/escritura local y remota
editor_wrap_contentWrap long editor lines. Lectura/escritura local y remota
editor_font_sizeEditor font size. Lectura/escritura local y remota
editor_status_barShow the editor status bar. Lectura/escritura local y remota
desktop_home_featuresFeatures displayed on the desktop home page. Lectura/escritura local y remota
desktop_rail_featuresFunciones mostradas en la barra de navegación de escritorio. Lectura/escritura local y remota
media_excluded_dirsDirectories hidden from media pages; file indexing and file search remain available. Lectura/escritura local y remota
desktop_upload_dirsRutas de los directorios de carga guardadas por categoría multimedia de escritorio. Lectura/escritura local y remota
audio_sort_byAudio-library sort order. Lectura/escritura local y remota
video_sort_byVideo-library sort order. Lectura/escritura local y remota
image_sort_byImage-library sort order. Lectura/escritura local y remota
doc_sort_byDocument-library sort order. Lectura/escritura local y remota
file_sort_byFile-browser sort order. Lectura/escritura local y remota
pkg_sort_byInstalled-package sort order. Lectura/escritura local y remota
audio_play_modeAudio playback repeat or shuffle mode. Lectura/escritura local y remota
audio_playback_speedAudio playback speed multiplier. Lectura/escritura local y remota
pomodoro_settingsPomodoro work, break and round configuration. Lectura/escritura local y remota
screen_mirror_qualityScreen-mirror quality preset. Lectura/escritura local y remota
clipboard_directionsClipboard synchronization direction for each peer. Solo lectura/escritura local
http_portHTTP listener port. Solo lectura/escritura local
https_portHTTPS listener port. Solo lectura/escritura local
background_service_enabledEnable the background service. Solo lectura/escritura local
remote_accessEnable remote access. Solo lectura/escritura local
developer_modeEnable developer tools and full preference or database access. Solo lectura/escritura local
allow_any_hostAllow requests with arbitrary HTTP host names. Solo lectura/escritura local
nearby_discoverableAllow nearby devices to discover this device. Solo lectura/escritura local
notification_filterNotification synchronization filter configuration. Solo lectura/escritura local
launcher_shortcutsConfigured launcher shortcuts. Solo lectura/escritura local
image_grid_cells_per_rowImage-grid column count. Solo lectura/escritura local
video_grid_cells_per_rowVideo-grid column count. Solo lectura/escritura local
httpsEnable HTTPS. Solo lectura/escritura local
web_address_bar_expandedExpand the remote-access address bar. Solo lectura/escritura local
passwordLocal password configuration. Solo lectura/escritura local
password_typeSelected password mode. Solo lectura/escritura local
login_require_approvalRequire local approval for remote login. Solo lectura/escritura local
api_permissionsFeatures authorized for remote API clients. Solo lectura/escritura local
dev_tokenDevelopment access token configuration. Solo lectura/escritura local
log_levelApplication logging level. Solo lectura/escritura local
auto_check_updateAutomatically check for application updates. Solo lectura/escritura local
skip_versionApplication update version to skip. Solo lectura/escritura local
mdns_hostnamemDNS hostname used for local discovery. Local o remoto autenticado con HTTP_SERVER
recent_selected_dirsHasta ocho rutas absolutas de carpetas confirmadas en este dispositivo, de más reciente a más antigua. En Windows se usa /; la raíz es D:/, no D:. ["D:/Projects/Photos", "E:/Backup/Photos"]Local o remoto autenticado con acceso a archivos
app_home_featuresFeatures displayed by the native Tools page and its remote projection. Lectura/escritura local; solo lectura remota
opaque_server_setupInternal OPAQUE password-authentication server setup. Solo uso interno de Rust
opaque_password_recordInternal OPAQUE password registration record. Solo uso interno de Rust
client_idInternal persistent device identity. Solo uso interno de Rust
adb_tokenInternal authorization token for local command access. Solo uso interno de Rust
master_secretInternal master secret. Solo uso interno de Rust
signature_key_pairInternal device signing key pair. Solo uso interno de Rust

Definiciones de tipos

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

Operaciones

subscription

prefsChanged

Recibir una señal cuando cambien las preferencias; volver a consultar los campos de configuración usados.

graphql
subscription prefsChanged {
  prefsChanged
}
mutation

removePref

Eliminar una sustitución de preferencia escribible; auto_check_update y skip_version vuelven a sus valores predeterminados. Consultar la lista de claves permitidas.

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

setPref

Establecer una preferencia registrada escribible, validar su valor y aplicar sus efectos secundarios. Consultar la lista de claves permitidas para los permisos.

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

prefs

Omitir keys o pasar null para leer todas las preferencias almacenadas sin procesar, incluidas las claves internas; requiere el modo de desarrollador. Las claves indicadas usan la lista de claves permitidas; una lista vacía devuelve un objeto vacío.

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