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.
| Chave | Finalidade | Acesso |
|---|---|---|
| dlna | Enable the DLNA service. | Leitura/escrita local e remota |
| device_name | Device display name. | Leitura/escrita local e remota |
| feed_auto_refresh | Enable automatic feed refresh. | Leitura/escrita local e remota |
| feed_auto_refresh_interval | Automatic feed refresh interval in seconds. | Leitura/escrita local e remota |
| feed_auto_refresh_only_wifi | Restrict automatic feed refresh to Wi-Fi. | Leitura/escrita local e remota |
| ai_image_search_enabled | Enable semantic image search. | Leitura/escrita local e remota |
| ai_image_search_model | Selected image-search model. | Leitura/escrita local e remota |
| dlna_allowed_senders | Allowed DLNA sender identities. | Leitura/escrita local e remota |
| dlna_denied_senders | Denied DLNA sender identities. | Leitura/escrita local e remota |
| dark_theme | Theme selection: USE_DEVICE_THEME, ON or OFF. | Leitura/escrita local e remota |
| amoled_dark_theme | Use the AMOLED dark-theme option. | Leitura/escrita local e remota |
| pdf_follow_dark_theme | Apply the current dark theme to PDF viewing. | Leitura/escrita local e remota |
| locale | Interface language. | Leitura/escrita local e remota |
| show_hidden_files | Show hidden files in file browsing. | Leitura/escrita local e remota |
| feed_font_scale | Feed-reader font scale. | Leitura/escrita local e remota |
| editor_wrap_content | Wrap long editor lines. | Leitura/escrita local e remota |
| editor_font_size | Editor font size. | Leitura/escrita local e remota |
| editor_status_bar | Show the editor status bar. | Leitura/escrita local e remota |
| desktop_home_features | Features displayed on the desktop home page. | Leitura/escrita local e remota |
| desktop_rail_features | Recursos exibidos na barra de navegação do desktop. | Leitura/escrita local e remota |
| media_excluded_dirs | Directories hidden from media pages; file indexing and file search remain available. | Leitura/escrita local e remota |
| desktop_upload_dirs | Caminhos dos diretórios de upload salvos por categoria de mídia do desktop. | Leitura/escrita local e remota |
| audio_sort_by | Audio-library sort order. | Leitura/escrita local e remota |
| video_sort_by | Video-library sort order. | Leitura/escrita local e remota |
| image_sort_by | Image-library sort order. | Leitura/escrita local e remota |
| doc_sort_by | Document-library sort order. | Leitura/escrita local e remota |
| file_sort_by | File-browser sort order. | Leitura/escrita local e remota |
| pkg_sort_by | Installed-package sort order. | Leitura/escrita local e remota |
| audio_play_mode | Audio playback repeat or shuffle mode. | Leitura/escrita local e remota |
| audio_playback_speed | Audio playback speed multiplier. | Leitura/escrita local e remota |
| pomodoro_settings | Pomodoro work, break and round configuration. | Leitura/escrita local e remota |
| screen_mirror_quality | Screen-mirror quality preset. | Leitura/escrita local e remota |
| clipboard_directions | Clipboard synchronization direction for each peer. | Apenas leitura/escrita local |
| http_port | HTTP listener port. | Apenas leitura/escrita local |
| https_port | HTTPS listener port. | Apenas leitura/escrita local |
| background_service_enabled | Enable the background service. | Apenas leitura/escrita local |
| remote_access | Enable remote access. | Apenas leitura/escrita local |
| developer_mode | Enable developer tools and full preference or database access. | Apenas leitura/escrita local |
| allow_any_host | Allow requests with arbitrary HTTP host names. | Apenas leitura/escrita local |
| nearby_discoverable | Allow nearby devices to discover this device. | Apenas leitura/escrita local |
| notification_filter | Notification synchronization filter configuration. | Apenas leitura/escrita local |
| launcher_shortcuts | Configured launcher shortcuts. | Apenas leitura/escrita local |
| image_grid_cells_per_row | Image-grid column count. | Apenas leitura/escrita local |
| video_grid_cells_per_row | Video-grid column count. | Apenas leitura/escrita local |
| https | Enable HTTPS. | Apenas leitura/escrita local |
| web_address_bar_expanded | Expand the remote-access address bar. | Apenas leitura/escrita local |
| password | Local password configuration. | Apenas leitura/escrita local |
| password_type | Selected password mode. | Apenas leitura/escrita local |
| login_require_approval | Require local approval for remote login. | Apenas leitura/escrita local |
| api_permissions | Features authorized for remote API clients. | Apenas leitura/escrita local |
| dev_token | Development access token configuration. | Apenas leitura/escrita local |
| log_level | Application logging level. | Apenas leitura/escrita local |
| auto_check_update | Automatically check for application updates. | Apenas leitura/escrita local |
| skip_version | Application update version to skip. | Apenas leitura/escrita local |
| mdns_hostname | mDNS hostname used for local discovery. | Local ou remoto autenticado com HTTP_SERVER |
| recent_selected_dirs | Até 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_features | Features displayed by the native Tools page and its remote projection. | Leitura/escrita local; apenas leitura remota |
| opaque_server_setup | Internal OPAQUE password-authentication server setup. | Apenas uso interno do Rust |
| opaque_password_record | Internal OPAQUE password registration record. | Apenas uso interno do Rust |
| client_id | Internal persistent device identity. | Apenas uso interno do Rust |
| adb_token | Internal authorization token for local command access. | Apenas uso interno do Rust |
| master_secret | Internal master secret. | Apenas uso interno do Rust |
| signature_key_pair | Internal device signing key pair. | Apenas uso interno do Rust |
Definições de Tipo
type Subscription {
prefsChanged: Boolean!
}
type Mutation {
removePref(key: String!): Boolean!
setPref(key: String!, value: JSON!): Boolean!
}
type Query {
prefs(keys: [String!]): JSON!
}
scalar JSONOperações
prefsChanged
Receber um sinal quando as preferências mudarem; voltar a consultar os campos de configuração utilizados.
subscription prefsChanged {
prefsChanged
}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.
mutation removePref($key: String!) {
removePref(key: $key)
}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.
mutation setPref($key: String!, $value: JSON!) {
setPref(key: $key, value: $value)
}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.
query prefs($keys: [String!]) {
prefs(keys: $keys)
}