Справочник API

Настройки

Конфигурация приложения. Полное чтение настроек требует режима разработчика; выборочное чтение и запись следуют приведённым ниже политикам зарегистрированных ключей.

Зарегистрированные ключи настроек (63)

Доступ определяется политикой каждого ключа. Чтение всех исходных значений требует режима разработчика.

КлючНазначениеДоступ
dlnaEnable the DLNA service. Локальное и удалённое чтение/запись
device_nameDevice display name. Локальное и удалённое чтение/запись
feed_auto_refreshEnable automatic feed refresh. Локальное и удалённое чтение/запись
feed_auto_refresh_intervalAutomatic feed refresh interval in seconds. Локальное и удалённое чтение/запись
feed_auto_refresh_only_wifiRestrict automatic feed refresh to Wi-Fi. Локальное и удалённое чтение/запись
ai_image_search_enabledEnable semantic image search. Локальное и удалённое чтение/запись
ai_image_search_modelSelected image-search model. Локальное и удалённое чтение/запись
dlna_allowed_sendersAllowed DLNA sender identities. Локальное и удалённое чтение/запись
dlna_denied_sendersDenied DLNA sender identities. Локальное и удалённое чтение/запись
dark_themeTheme selection: USE_DEVICE_THEME, ON or OFF. Локальное и удалённое чтение/запись
amoled_dark_themeUse the AMOLED dark-theme option. Локальное и удалённое чтение/запись
pdf_follow_dark_themeApply the current dark theme to PDF viewing. Локальное и удалённое чтение/запись
localeInterface language. Локальное и удалённое чтение/запись
show_hidden_filesShow hidden files in file browsing. Локальное и удалённое чтение/запись
feed_font_scaleFeed-reader font scale. Локальное и удалённое чтение/запись
editor_wrap_contentWrap long editor lines. Локальное и удалённое чтение/запись
editor_font_sizeEditor font size. Локальное и удалённое чтение/запись
editor_status_barShow the editor status bar. Локальное и удалённое чтение/запись
desktop_home_featuresFeatures displayed on the desktop home page. Локальное и удалённое чтение/запись
desktop_rail_featuresФункции, отображаемые на панели навигации настольного приложения. Локальное и удалённое чтение/запись
media_excluded_dirsDirectories hidden from media pages; file indexing and file search remain available. Локальное и удалённое чтение/запись
desktop_upload_dirsПути каталогов загрузки, сохранённые для каждой категории медиа настольного приложения. Локальное и удалённое чтение/запись
audio_sort_byAudio-library sort order. Локальное и удалённое чтение/запись
video_sort_byVideo-library sort order. Локальное и удалённое чтение/запись
image_sort_byImage-library sort order. Локальное и удалённое чтение/запись
doc_sort_byDocument-library sort order. Локальное и удалённое чтение/запись
file_sort_byFile-browser sort order. Локальное и удалённое чтение/запись
pkg_sort_byInstalled-package sort order. Локальное и удалённое чтение/запись
audio_play_modeAudio playback repeat or shuffle mode. Локальное и удалённое чтение/запись
audio_playback_speedAudio playback speed multiplier. Локальное и удалённое чтение/запись
pomodoro_settingsPomodoro work, break and round configuration. Локальное и удалённое чтение/запись
screen_mirror_qualityScreen-mirror quality preset. Локальное и удалённое чтение/запись
clipboard_directionsClipboard synchronization direction for each peer. Только локальное чтение/запись
http_portHTTP listener port. Только локальное чтение/запись
https_portHTTPS listener port. Только локальное чтение/запись
background_service_enabledEnable the background service. Только локальное чтение/запись
remote_accessEnable remote access. Только локальное чтение/запись
developer_modeEnable developer tools and full preference or database access. Только локальное чтение/запись
allow_any_hostAllow requests with arbitrary HTTP host names. Только локальное чтение/запись
nearby_discoverableAllow nearby devices to discover this device. Только локальное чтение/запись
notification_filterNotification synchronization filter configuration. Только локальное чтение/запись
launcher_shortcutsConfigured launcher shortcuts. Только локальное чтение/запись
image_grid_cells_per_rowImage-grid column count. Только локальное чтение/запись
video_grid_cells_per_rowVideo-grid column count. Только локальное чтение/запись
httpsEnable HTTPS. Только локальное чтение/запись
web_address_bar_expandedExpand the remote-access address bar. Только локальное чтение/запись
passwordLocal password configuration. Только локальное чтение/запись
password_typeSelected password mode. Только локальное чтение/запись
login_require_approvalRequire local approval for remote login. Только локальное чтение/запись
api_permissionsFeatures authorized for remote API clients. Только локальное чтение/запись
dev_tokenDevelopment access token configuration. Только локальное чтение/запись
log_levelApplication logging level. Только локальное чтение/запись
auto_check_updateAutomatically check for application updates. Только локальное чтение/запись
skip_versionApplication update version to skip. Только локальное чтение/запись
mdns_hostnamemDNS hostname used for local discovery. Локальный или авторизованный удалённый с HTTP_SERVER
recent_selected_dirsДо восьми абсолютных путей к выбранным папкам на этом устройстве, сначала новые. В Windows используется /; корень диска — D:/, а не D:. ["D:/Projects/Photos", "E:/Backup/Photos"]Локально или удалённо после входа с доступом к файлам
app_home_featuresFeatures displayed by the native Tools page and its remote projection. Локальное чтение/запись; удалённо только чтение
opaque_server_setupInternal OPAQUE password-authentication server setup. Только для внутреннего использования Rust
opaque_password_recordInternal OPAQUE password registration record. Только для внутреннего использования Rust
client_idInternal persistent device identity. Только для внутреннего использования Rust
adb_tokenInternal authorization token for local command access. Только для внутреннего использования Rust
master_secretInternal master secret. Только для внутреннего использования Rust
signature_key_pairInternal device signing key pair. Только для внутреннего использования Rust

Определения типов

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

Операции

subscription

prefsChanged

Получает сигнал об изменении настроек; повторно запросите используемые поля конфигурации.

graphql
subscription prefsChanged {
  prefsChanged
}
mutation

removePref

Удаляет переопределение доступной для записи настройки; auto_check_update и skip_version сбрасываются к значениям по умолчанию. См. белый список ключей.

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

setPref

Задаёт зарегистрированную доступную для записи настройку, проверяет значение и применяет побочные эффекты. Разрешения см. в белом списке ключей.

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

prefs

Опустите keys или передайте null для чтения всех сохранённых настроек в исходном виде, включая внутренние ключи; требуется режим разработчика. Именованные ключи используют белый список; пустой список возвращает пустой объект.

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