PlainApp
Referência da API

Preferências

Configuração da aplicação. A leitura completa das preferências exige o Modo de Programador; as leituras seletivas e escritas seguem as políticas de chaves registadas abaixo.

Chaves de preferências registradas (63)

O acesso segue a política de cada chave. A leitura de todos os valores brutos exige o modo de desenvolvedor.

ChaveFinalidadeAcesso
dlnaEnable the DLNA service. Leitura/escrita local e remota
device_nameDevice display name. Leitura/escrita local e remota
feed_auto_refreshEnable automatic feed refresh. Leitura/escrita local e remota
feed_auto_refresh_intervalAutomatic feed refresh interval in seconds. Leitura/escrita local e remota
feed_auto_refresh_only_wifiRestrict automatic feed refresh to Wi-Fi. Leitura/escrita local e remota
ai_image_search_enabledEnable semantic image search. Leitura/escrita local e remota
ai_image_search_modelSelected image-search model. Leitura/escrita local e remota
dlna_allowed_sendersAllowed DLNA sender identities. Leitura/escrita local e remota
dlna_denied_sendersDenied DLNA sender identities. Leitura/escrita local e remota
dark_themeTheme selection: USE_DEVICE_THEME, ON or OFF. Leitura/escrita local e remota
amoled_dark_themeUse the AMOLED dark-theme option. Leitura/escrita local e remota
pdf_follow_dark_themeApply the current dark theme to PDF viewing. Leitura/escrita local e remota
localeInterface language. Leitura/escrita local e remota
show_hidden_filesShow hidden files in file browsing. Leitura/escrita local e remota
feed_font_scaleFeed-reader font scale. Leitura/escrita local e remota
editor_wrap_contentWrap long editor lines. Leitura/escrita local e remota
editor_font_sizeEditor font size. Leitura/escrita local e remota
editor_status_barShow the editor status bar. Leitura/escrita local e remota
desktop_home_featuresFeatures displayed on the desktop home page. Leitura/escrita local e remota
desktop_rail_featuresRecursos exibidos na barra de navegação do desktop. Leitura/escrita local e remota
media_excluded_dirsDirectories hidden from media pages; file indexing and file search remain available. Leitura/escrita local e remota
desktop_upload_dirsCaminhos dos diretórios de upload salvos por categoria de mídia do desktop. Leitura/escrita local e remota
audio_sort_byAudio-library sort order. Leitura/escrita local e remota
video_sort_byVideo-library sort order. Leitura/escrita local e remota
image_sort_byImage-library sort order. Leitura/escrita local e remota
doc_sort_byDocument-library sort order. Leitura/escrita local e remota
file_sort_byFile-browser sort order. Leitura/escrita local e remota
pkg_sort_byInstalled-package sort order. Leitura/escrita local e remota
audio_play_modeAudio playback repeat or shuffle mode. Leitura/escrita local e remota
audio_playback_speedAudio playback speed multiplier. Leitura/escrita local e remota
pomodoro_settingsPomodoro work, break and round configuration. Leitura/escrita local e remota
screen_mirror_qualityScreen-mirror quality preset. Leitura/escrita local e remota
clipboard_directionsClipboard synchronization direction for each peer. Apenas leitura/escrita local
http_portHTTP listener port. Apenas leitura/escrita local
https_portHTTPS listener port. Apenas leitura/escrita local
background_service_enabledEnable the background service. Apenas leitura/escrita local
remote_accessEnable remote access. Apenas leitura/escrita local
developer_modeEnable developer tools and full preference or database access. Apenas leitura/escrita local
allow_any_hostAllow requests with arbitrary HTTP host names. Apenas leitura/escrita local
nearby_discoverableAllow nearby devices to discover this device. Apenas leitura/escrita local
notification_filterNotification synchronization filter configuration. Apenas leitura/escrita local
launcher_shortcutsConfigured launcher shortcuts. Apenas leitura/escrita local
image_grid_cells_per_rowImage-grid column count. Apenas leitura/escrita local
video_grid_cells_per_rowVideo-grid column count. Apenas leitura/escrita local
httpsEnable HTTPS. Apenas leitura/escrita local
web_address_bar_expandedExpand the remote-access address bar. Apenas leitura/escrita local
passwordLocal password configuration. Apenas leitura/escrita local
password_typeSelected password mode. Apenas leitura/escrita local
login_require_approvalRequire local approval for remote login. Apenas leitura/escrita local
api_permissionsFeatures authorized for remote API clients. Apenas leitura/escrita local
dev_tokenDevelopment access token configuration. Apenas leitura/escrita local
log_levelApplication logging level. Apenas leitura/escrita local
auto_check_updateAutomatically check for application updates. Apenas leitura/escrita local
skip_versionApplication update version to skip. Apenas leitura/escrita local
mdns_hostnamemDNS hostname used for local discovery. Local ou remoto autenticado com HTTP_SERVER
recent_selected_dirsAté oito caminhos absolutos de pastas confirmadas neste dispositivo, do mais recente ao mais antigo. No Windows, use /; a raiz é D:/, não D:. ["D:/Projects/Photos", "E:/Backup/Photos"]Local ou remoto autenticado com acesso a arquivos
app_home_featuresFeatures displayed by the native Tools page and its remote projection. Leitura/escrita local; apenas leitura remota
opaque_server_setupInternal OPAQUE password-authentication server setup. Apenas uso interno do Rust
opaque_password_recordInternal OPAQUE password registration record. Apenas uso interno do Rust
client_idInternal persistent device identity. Apenas uso interno do Rust
adb_tokenInternal authorization token for local command access. Apenas uso interno do Rust
master_secretInternal master secret. Apenas uso interno do Rust
signature_key_pairInternal device signing key pair. Apenas uso interno do Rust

Definições de 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

Operações

subscription

prefsChanged

Receber um sinal quando as preferências mudarem; voltar a consultar os campos de configuração utilizados.

graphql
subscription prefsChanged {
  prefsChanged
}
mutation

removePref

Remover uma substituição de preferência gravável; auto_check_update e skip_version regressam aos valores predefinidos. Consultar a lista de chaves permitidas.

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

setPref

Definir uma preferência registada gravável, validar o valor e aplicar os respetivos efeitos. Consultar a lista de chaves permitidas para as permissões.

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

prefs

Omitir keys ou passar null para ler todas as preferências em bruto guardadas, incluindo chaves internas; exige o Modo de Programador. As chaves indicadas usam a lista permitida; uma lista vazia devolve um objeto vazio.

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