docs(launcher): document post delay override
This commit is contained in:
@@ -325,19 +325,20 @@ immediately. See `PROJECT__AE_Events_Launcher_Native_integration.md` Section 8.
|
|||||||
|
|
||||||
These are the initial built-in defaults shipped with the Launcher. They are the Svelte-side
|
These are the initial built-in defaults shipped with the Launcher. They are the Svelte-side
|
||||||
fallbacks used when neither device config nor event config defines a profile for the file
|
fallbacks used when neither device config nor event config defines a profile for the file
|
||||||
extension. Each canonical profile can have multiple extension aliases.
|
extension. Each canonical profile can have multiple extension aliases. `post_delay_ms` is part
|
||||||
|
of the profile object, so a device-specific `launch_profiles` entry can override it later.
|
||||||
|
|
||||||
| Profile name | Extension aliases | Default app | Display mode | Notes |
|
| Profile name | Extension aliases | Default app | Display mode | Post delay | Notes |
|
||||||
|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| `powerpoint_mac_extend` | `pptx`, `ppt` | Microsoft PowerPoint for macOS | `extend` | Open in the presentation app and extend to an external display if one is present. |
|
| `powerpoint_mac_extend` | `pptx`, `ppt` | Microsoft PowerPoint for macOS | `extend` | `2000ms` | Open in the presentation app and extend to an external display if one is present. |
|
||||||
| `keynote_mac_extend` | `key` | Keynote | `extend` | Keynote slideshow on the external display if available. |
|
| `keynote_mac_extend` | `key` | Keynote | `extend` | `2000ms` | Keynote slideshow on the external display if available. |
|
||||||
| `libreoffice_mac_extend` | `odp` | LibreOffice for macOS | `extend` | LibreOffice Impress for OpenDocument presentations. |
|
| `libreoffice_mac_extend` | `odp` | LibreOffice for macOS | `extend` | `2000ms` | LibreOffice Impress for OpenDocument presentations. |
|
||||||
| `acrobat_mac_mirror` | `pdf` | Adobe Acrobat for macOS | `mirror` | PDF handout / deck view uses mirrored display. |
|
| `acrobat_mac_mirror` | `pdf` | Adobe Acrobat for macOS | `mirror` | `2000ms` | PDF handout / deck view uses mirrored display. |
|
||||||
| `vlc_mirror` | `mp4`, `mkv`, `mp3`, `m4v`, `m4a`, `webm`, `wav`, `aac`, `flac`, `mov`, `mpeg`, `avi`, `flv`, `ogg`, `ogv`, `wmv` | VLC for macOS | `mirror` | Media playback is mirrored so the room sees the same output as the operator. |
|
| `vlc_mirror` | `mp4`, `mkv`, `mp3`, `m4v`, `m4a`, `webm`, `wav`, `aac`, `flac`, `mov`, `mpeg`, `avi`, `flv`, `ogg`, `ogv`, `wmv` | VLC for macOS | `mirror` | `2000ms` | Media playback is mirrored so the room sees the same output as the operator. |
|
||||||
| `powerpoint_win_extend` | `pptxwin`, `pptwin` | PowerPoint for Windows (Parallels) | `extend` | Windows PowerPoint profile for Parallels-based rooms. |
|
| `powerpoint_win_extend` | `pptxwin`, `pptwin` | PowerPoint for Windows (Parallels) | `extend` | `3000ms` | Windows PowerPoint profile for Parallels-based rooms. |
|
||||||
| `libreoffice_win_extend` | `odpwin` | LibreOffice for Windows | `extend` | Windows LibreOffice profile for Parallels-based rooms. |
|
| `libreoffice_win_extend` | `odpwin` | LibreOffice for Windows | `extend` | `3000ms` | Windows LibreOffice profile for Parallels-based rooms. |
|
||||||
| `acrobat_win_mirror` | `pdfwin` | Adobe Acrobat for Windows (Parallels) | `mirror` | Windows PDF profile for mirrored display rooms. |
|
| `acrobat_win_mirror` | `pdfwin` | Adobe Acrobat for Windows (Parallels) | `mirror` | `3000ms` | Windows PDF profile for mirrored display rooms. |
|
||||||
| `url_web` | `url` | Browser / Event File web presentation | `extend` | Web-based presentations are handled as Event File URLs rather than cached local files. |
|
| `url_web` | `url` | Browser / Event File web presentation | `extend` | `n/a` | Web-based presentations are handled as Event File URLs rather than cached local files. |
|
||||||
|
|
||||||
Versioning is handled automatically: when a presenter uploads an updated file, the new
|
Versioning is handled automatically: when a presenter uploads an updated file, the new
|
||||||
hash is cached separately and the old one remains intact.
|
hash is cached separately and the old one remains intact.
|
||||||
|
|||||||
@@ -202,8 +202,9 @@ The native layer should not invent or guess a default launch path.
|
|||||||
|
|
||||||
The built-in defaults are organized as canonical profile names plus extension aliases. That
|
The built-in defaults are organized as canonical profile names plus extension aliases. That
|
||||||
lets multiple file types share one profile without repeating the same app/script details.
|
lets multiple file types share one profile without repeating the same app/script details.
|
||||||
URL-based presentations remain a special pseudo-extension handled separately from the cache
|
The profile object also carries `post_delay_ms`, so a device-specific `launch_profiles`
|
||||||
open flow.
|
override can tune the delay without changing the bridge contract. URL-based presentations
|
||||||
|
remain a special pseudo-extension handled separately from the cache open flow.
|
||||||
|
|
||||||
### Native Template Formats
|
### Native Template Formats
|
||||||
|
|
||||||
|
|||||||
@@ -41,7 +41,10 @@ export interface LaunchProfile {
|
|||||||
* Plain string → AppleScript (macOS). "shell:" prefix → shell command.
|
* Plain string → AppleScript (macOS). "shell:" prefix → shell command.
|
||||||
*/
|
*/
|
||||||
post_script?: string;
|
post_script?: string;
|
||||||
/** Milliseconds to wait after open_cmd before running post_script. Default: 2000 */
|
/**
|
||||||
|
* Milliseconds to wait after open_cmd before running post_script.
|
||||||
|
* Default: 2000. Can be overridden per device via launch_profiles.
|
||||||
|
*/
|
||||||
post_delay_ms?: number;
|
post_delay_ms?: number;
|
||||||
|
|
||||||
// --- Reserved for future use — not yet implemented ---
|
// --- Reserved for future use — not yet implemented ---
|
||||||
|
|||||||
Reference in New Issue
Block a user