Référence de l'API

Préférences

Configuration de l’application. La lecture complète des préférences nécessite le mode développeur ; les lectures ciblées et les écritures suivent les politiques des clés enregistrées ci-dessous.

Clés de préférences enregistrées (63)

L’accès suit la politique de chaque clé. La lecture de toutes les valeurs brutes nécessite le mode développeur.

CléUtilisationAccès
dlnaEnable the DLNA service. Lecture/écriture locale et distante
device_nameDevice display name. Lecture/écriture locale et distante
feed_auto_refreshEnable automatic feed refresh. Lecture/écriture locale et distante
feed_auto_refresh_intervalAutomatic feed refresh interval in seconds. Lecture/écriture locale et distante
feed_auto_refresh_only_wifiRestrict automatic feed refresh to Wi-Fi. Lecture/écriture locale et distante
ai_image_search_enabledEnable semantic image search. Lecture/écriture locale et distante
ai_image_search_modelSelected image-search model. Lecture/écriture locale et distante
dlna_allowed_sendersAllowed DLNA sender identities. Lecture/écriture locale et distante
dlna_denied_sendersDenied DLNA sender identities. Lecture/écriture locale et distante
dark_themeTheme selection: USE_DEVICE_THEME, ON or OFF. Lecture/écriture locale et distante
amoled_dark_themeUse the AMOLED dark-theme option. Lecture/écriture locale et distante
pdf_follow_dark_themeApply the current dark theme to PDF viewing. Lecture/écriture locale et distante
localeInterface language. Lecture/écriture locale et distante
show_hidden_filesShow hidden files in file browsing. Lecture/écriture locale et distante
feed_font_scaleFeed-reader font scale. Lecture/écriture locale et distante
editor_wrap_contentWrap long editor lines. Lecture/écriture locale et distante
editor_font_sizeEditor font size. Lecture/écriture locale et distante
editor_status_barShow the editor status bar. Lecture/écriture locale et distante
desktop_home_featuresFeatures displayed on the desktop home page. Lecture/écriture locale et distante
desktop_rail_featuresFonctionnalités affichées dans la barre de navigation du bureau. Lecture/écriture locale et distante
media_excluded_dirsDirectories hidden from media pages; file indexing and file search remain available. Lecture/écriture locale et distante
desktop_upload_dirsChemins des dossiers d’envoi enregistrés par catégorie de médias du bureau. Lecture/écriture locale et distante
audio_sort_byAudio-library sort order. Lecture/écriture locale et distante
video_sort_byVideo-library sort order. Lecture/écriture locale et distante
image_sort_byImage-library sort order. Lecture/écriture locale et distante
doc_sort_byDocument-library sort order. Lecture/écriture locale et distante
file_sort_byFile-browser sort order. Lecture/écriture locale et distante
pkg_sort_byInstalled-package sort order. Lecture/écriture locale et distante
audio_play_modeAudio playback repeat or shuffle mode. Lecture/écriture locale et distante
audio_playback_speedAudio playback speed multiplier. Lecture/écriture locale et distante
pomodoro_settingsPomodoro work, break and round configuration. Lecture/écriture locale et distante
screen_mirror_qualityScreen-mirror quality preset. Lecture/écriture locale et distante
clipboard_directionsClipboard synchronization direction for each peer. Lecture/écriture locale uniquement
http_portHTTP listener port. Lecture/écriture locale uniquement
https_portHTTPS listener port. Lecture/écriture locale uniquement
background_service_enabledEnable the background service. Lecture/écriture locale uniquement
remote_accessEnable remote access. Lecture/écriture locale uniquement
developer_modeEnable developer tools and full preference or database access. Lecture/écriture locale uniquement
allow_any_hostAllow requests with arbitrary HTTP host names. Lecture/écriture locale uniquement
nearby_discoverableAllow nearby devices to discover this device. Lecture/écriture locale uniquement
notification_filterNotification synchronization filter configuration. Lecture/écriture locale uniquement
launcher_shortcutsConfigured launcher shortcuts. Lecture/écriture locale uniquement
image_grid_cells_per_rowImage-grid column count. Lecture/écriture locale uniquement
video_grid_cells_per_rowVideo-grid column count. Lecture/écriture locale uniquement
httpsEnable HTTPS. Lecture/écriture locale uniquement
web_address_bar_expandedExpand the remote-access address bar. Lecture/écriture locale uniquement
passwordLocal password configuration. Lecture/écriture locale uniquement
password_typeSelected password mode. Lecture/écriture locale uniquement
login_require_approvalRequire local approval for remote login. Lecture/écriture locale uniquement
api_permissionsFeatures authorized for remote API clients. Lecture/écriture locale uniquement
dev_tokenDevelopment access token configuration. Lecture/écriture locale uniquement
log_levelApplication logging level. Lecture/écriture locale uniquement
auto_check_updateAutomatically check for application updates. Lecture/écriture locale uniquement
skip_versionApplication update version to skip. Lecture/écriture locale uniquement
mdns_hostnamemDNS hostname used for local discovery. Local ou distant authentifié avec HTTP_SERVER
recent_selected_dirsJusqu’à huit chemins absolus de dossiers confirmés sur cet appareil, du plus récent au plus ancien. Sous Windows, utilisez / ; la racine est D:/, pas D:. ["D:/Projects/Photos", "E:/Backup/Photos"]En local ou à distance après connexion, avec accès aux fichiers
app_home_featuresFeatures displayed by the native Tools page and its remote projection. Lecture/écriture locale ; lecture distante seule
opaque_server_setupInternal OPAQUE password-authentication server setup. Usage interne Rust uniquement
opaque_password_recordInternal OPAQUE password registration record. Usage interne Rust uniquement
client_idInternal persistent device identity. Usage interne Rust uniquement
adb_tokenInternal authorization token for local command access. Usage interne Rust uniquement
master_secretInternal master secret. Usage interne Rust uniquement
signature_key_pairInternal device signing key pair. Usage interne Rust uniquement

Définitions de types

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

Opérations

subscription

prefsChanged

Recevoir un signal lorsque les préférences changent ; recharger les champs de configuration utilisés.

graphql
subscription prefsChanged {
  prefsChanged
}
mutation

removePref

Supprimer une valeur de remplacement de préférence modifiable ; auto_check_update et skip_version reprennent leurs valeurs par défaut. Consulter la liste des clés autorisées.

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

setPref

Définir une préférence enregistrée modifiable, valider sa valeur et appliquer ses effets. Consulter la liste des clés autorisées pour les permissions.

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

prefs

Omettre keys ou fournir null pour lire toutes les préférences brutes enregistrées, y compris les clés internes ; le mode développeur est requis. Les clés nommées utilisent la liste autorisée ; une liste vide renvoie un objet vide.

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