forked from Blendman974/faceclaw
Use TTF fonts throughout the UI; also add some more functions to app extension API
This commit is contained in:
1 parent
5abbe2a405
commit
96842ceb23
82 files changed
+2666
-288
No files matched your search
@@ -79,9 +79,47 @@ brief:
|
||||
| `getConfiguredApiKeys(): Promise<ApiKeyService[]>` | Which keys the user configured (names only). |
|
||||
| `requestApiKeyAccess(services): Promise<Partial<Record<ApiKeyService, string>>>` | Prompt for and return key values. |
|
||||
| `playBuzzer(steps): Promise<void>` | Play a piezo tone sequence. |
|
||||
| `addCompassListener(fn): () => void` | Activate the magnetometer; receive heading samples. Uncalibrated (see note). |
|
||||
| `createLayout(layout): Promise<boolean>` | Build the initial page (extended layout: full 576×452, no count limit, `preserve`). |
|
||||
| `replaceLayout(layout): Promise<boolean>` | Replace the page; `preserve` containers inherit content by name. |
|
||||
| `setAssistantTools(tools): void` | Contribute voice-assistant tools (namespaced by package name). |
|
||||
|
||||
`ApiKeyService` is one of `"openai" | "anthropic" | "soniox" | "elevenlabs" | "mapbox"`.
|
||||
|
||||
### Compass
|
||||
|
||||
`addCompassListener` is **not pre-calibrated**: the magnetometer is inside the
|
||||
right arm, which rests on the head with a slight curl that differs between
|
||||
wearers and wears. Treat the heading as relative — let the user zero it.
|
||||
|
||||
### Extended layout
|
||||
|
||||
`createLayout` / `replaceLayout` accept the same `textObject` / `imageObject` /
|
||||
`listObject` shape as the stock `createStartUpPageContainer` /
|
||||
`rebuildPageContainer` (so you can keep using the SDK's container builders),
|
||||
plus: the canvas is the full **576×452** app area (image containers may fill it),
|
||||
there is **no container-count limit**, and any container may set `preserve: true`
|
||||
to inherit its content from the same-named container in the previous layout.
|
||||
`containerID` remains the identity for `updateImageRawData` / `textContainerUpgrade`.
|
||||
|
||||
### Voice-assistant tools
|
||||
|
||||
```ts
|
||||
fc.setAssistantTools([
|
||||
{
|
||||
name: "set_bpm",
|
||||
description: "Set the metronome tempo.",
|
||||
parameters: { type: "object", properties: { bpm: { type: "number" } }, required: ["bpm"] },
|
||||
availability: "open", // or "foreground" (default)
|
||||
handler: ({ bpm }) => { setTempo(bpm); return `tempo is now ${bpm}`; },
|
||||
},
|
||||
]);
|
||||
```
|
||||
|
||||
The assistant sees each tool namespaced by your package name
|
||||
(`app.<packageName>.set_bpm`). The handler's return value is reported back to the
|
||||
assistant; throwing reports an error.
|
||||
|
||||
## Stability
|
||||
|
||||
Pre-1.0: the surface may still change. Once it stabilizes, additive-only changes
|
||||
|
||||
Reference in new issue
Block a user