dev.avyos.settings
api/settings/api.json
Persistent key/value settings service used by desktop and system apps.
Service
| Field | Value |
|---|---|
| Name | dev.avyos.settings |
| Package | settings |
| Service ID | 0x00000060 |
Persistent key/value settings service used by desktop and system apps.
Types
Empty
Empty payload used where no data is required.
No fields.
KeyRequest
Lookup payload for a single settings key.
| Field | Type | Description |
|---|---|---|
Key |
string |
- |
SetRequest
Write payload for a key/value update.
| Field | Type | Description |
|---|---|---|
Key |
string |
- |
Value |
string |
- |
ListRequest
List query payload filtered by key prefix.
| Field | Type | Description |
|---|---|---|
Prefix |
string |
- |
GetResponse
Response payload for value retrieval.
| Field | Type | Description |
|---|---|---|
Value |
string |
- |
Entry
Single key/value entry.
| Field | Type | Description |
|---|---|---|
Key |
string |
- |
Value |
string |
- |
EntryList
List of settings entries.
| Field | Type | Description |
|---|---|---|
Items |
[]Entry |
- |
ChangedEvent
Event payload emitted when a value changes.
| Field | Type | Description |
|---|---|---|
Key |
string |
- |
Value |
string |
- |
Requests
RawGet
0x0201
Read a setting value by key.
Input
Type: KeyRequest
Contains the full key path to read.
Output
Type: GetResponse
Returns the stored value.
RawSet
0x0202
Write or update a setting value by key.
Input
Type: SetRequest
Contains key and value to persist.
Output
Type: Empty
No payload is returned.
RawList
0x0203
List settings entries with an optional prefix filter.
Input
Type: ListRequest
Optional prefix to limit returned keys.
Output
Type: EntryList
Returns matching key/value entries.
Events
SettingsChanged
0x0301
Published when a key is created or updated.
Payload
Type: ChangedEvent
Contains changed key and new value.