API 참조
환경설정
앱 설정입니다. 전체 설정 읽기에는 개발자 모드가 필요하며 범위가 지정된 읽기와 쓰기는 아래 등록 키 정책을 따릅니다.
등록된 환경설정 키 (63)
접근 권한은 각 키의 등록 정책을 따릅니다. 저장된 원시 값을 모두 읽으려면 개발자 모드가 필요합니다.
| 키 | 용도 | 접근 권한 |
|---|---|---|
| dlna | Enable the DLNA service. | 로컬 및 원격 읽기/쓰기 |
| device_name | Device display name. | 로컬 및 원격 읽기/쓰기 |
| feed_auto_refresh | Enable automatic feed refresh. | 로컬 및 원격 읽기/쓰기 |
| feed_auto_refresh_interval | Automatic feed refresh interval in seconds. | 로컬 및 원격 읽기/쓰기 |
| feed_auto_refresh_only_wifi | Restrict automatic feed refresh to Wi-Fi. | 로컬 및 원격 읽기/쓰기 |
| ai_image_search_enabled | Enable semantic image search. | 로컬 및 원격 읽기/쓰기 |
| ai_image_search_model | Selected image-search model. | 로컬 및 원격 읽기/쓰기 |
| dlna_allowed_senders | Allowed DLNA sender identities. | 로컬 및 원격 읽기/쓰기 |
| dlna_denied_senders | Denied DLNA sender identities. | 로컬 및 원격 읽기/쓰기 |
| dark_theme | Theme selection: USE_DEVICE_THEME, ON or OFF. | 로컬 및 원격 읽기/쓰기 |
| amoled_dark_theme | Use the AMOLED dark-theme option. | 로컬 및 원격 읽기/쓰기 |
| pdf_follow_dark_theme | Apply the current dark theme to PDF viewing. | 로컬 및 원격 읽기/쓰기 |
| locale | Interface language. | 로컬 및 원격 읽기/쓰기 |
| show_hidden_files | Show hidden files in file browsing. | 로컬 및 원격 읽기/쓰기 |
| feed_font_scale | Feed-reader font scale. | 로컬 및 원격 읽기/쓰기 |
| editor_wrap_content | Wrap long editor lines. | 로컬 및 원격 읽기/쓰기 |
| editor_font_size | Editor font size. | 로컬 및 원격 읽기/쓰기 |
| editor_status_bar | Show the editor status bar. | 로컬 및 원격 읽기/쓰기 |
| desktop_home_features | Features displayed on the desktop home page. | 로컬 및 원격 읽기/쓰기 |
| desktop_rail_features | 데스크톱 탐색 모음에 표시할 기능. | 로컬 및 원격 읽기/쓰기 |
| media_excluded_dirs | Directories hidden from media pages; file indexing and file search remain available. | 로컬 및 원격 읽기/쓰기 |
| desktop_upload_dirs | 데스크톱 미디어 범주별로 저장된 업로드 디렉터리 경로. | 로컬 및 원격 읽기/쓰기 |
| audio_sort_by | Audio-library sort order. | 로컬 및 원격 읽기/쓰기 |
| video_sort_by | Video-library sort order. | 로컬 및 원격 읽기/쓰기 |
| image_sort_by | Image-library sort order. | 로컬 및 원격 읽기/쓰기 |
| doc_sort_by | Document-library sort order. | 로컬 및 원격 읽기/쓰기 |
| file_sort_by | File-browser sort order. | 로컬 및 원격 읽기/쓰기 |
| pkg_sort_by | Installed-package sort order. | 로컬 및 원격 읽기/쓰기 |
| audio_play_mode | Audio playback repeat or shuffle mode. | 로컬 및 원격 읽기/쓰기 |
| audio_playback_speed | Audio playback speed multiplier. | 로컬 및 원격 읽기/쓰기 |
| pomodoro_settings | Pomodoro work, break and round configuration. | 로컬 및 원격 읽기/쓰기 |
| screen_mirror_quality | Screen-mirror quality preset. | 로컬 및 원격 읽기/쓰기 |
| clipboard_directions | Clipboard synchronization direction for each peer. | 로컬 읽기/쓰기만 허용 |
| http_port | HTTP listener port. | 로컬 읽기/쓰기만 허용 |
| https_port | HTTPS listener port. | 로컬 읽기/쓰기만 허용 |
| background_service_enabled | Enable the background service. | 로컬 읽기/쓰기만 허용 |
| remote_access | Enable remote access. | 로컬 읽기/쓰기만 허용 |
| developer_mode | Enable developer tools and full preference or database access. | 로컬 읽기/쓰기만 허용 |
| allow_any_host | Allow requests with arbitrary HTTP host names. | 로컬 읽기/쓰기만 허용 |
| nearby_discoverable | Allow nearby devices to discover this device. | 로컬 읽기/쓰기만 허용 |
| notification_filter | Notification synchronization filter configuration. | 로컬 읽기/쓰기만 허용 |
| launcher_shortcuts | Configured launcher shortcuts. | 로컬 읽기/쓰기만 허용 |
| image_grid_cells_per_row | Image-grid column count. | 로컬 읽기/쓰기만 허용 |
| video_grid_cells_per_row | Video-grid column count. | 로컬 읽기/쓰기만 허용 |
| https | Enable HTTPS. | 로컬 읽기/쓰기만 허용 |
| web_address_bar_expanded | Expand the remote-access address bar. | 로컬 읽기/쓰기만 허용 |
| password | Local password configuration. | 로컬 읽기/쓰기만 허용 |
| password_type | Selected password mode. | 로컬 읽기/쓰기만 허용 |
| login_require_approval | Require local approval for remote login. | 로컬 읽기/쓰기만 허용 |
| api_permissions | Features authorized for remote API clients. | 로컬 읽기/쓰기만 허용 |
| dev_token | Development access token configuration. | 로컬 읽기/쓰기만 허용 |
| log_level | Application logging level. | 로컬 읽기/쓰기만 허용 |
| auto_check_update | Automatically check for application updates. | 로컬 읽기/쓰기만 허용 |
| skip_version | Application update version to skip. | 로컬 읽기/쓰기만 허용 |
| mdns_hostname | mDNS hostname used for local discovery. | 로컬 또는 HTTP_SERVER 기능을 갖춘 인증된 원격 |
| recent_selected_dirs | 이 기기에서 선택을 확정한 폴더의 절대 경로를 최신순으로 최대 8개 저장합니다. Windows에서는 /를 쓰며, 드라이브 루트는 D:가 아닌 D:/입니다. ["D:/Projects/Photos", "E:/Backup/Photos"] | 로컬 또는 로그인한 원격 클라이언트 중 파일 접근 권한이 있는 경우 |
| app_home_features | Features displayed by the native Tools page and its remote projection. | 로컬 읽기/쓰기, 원격 읽기 전용 |
| opaque_server_setup | Internal OPAQUE password-authentication server setup. | Rust 내부 전용 |
| opaque_password_record | Internal OPAQUE password registration record. | Rust 내부 전용 |
| client_id | Internal persistent device identity. | Rust 내부 전용 |
| adb_token | Internal authorization token for local command access. | Rust 내부 전용 |
| master_secret | Internal master secret. | Rust 내부 전용 |
| signature_key_pair | Internal 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)
}