Skip to content

image

A bitmap image, fetched from a URL by the phone’s browser. Use it for prompt artwork, avatars, current-round artwork, or any visual that should match the host’s game state.

src supports {key} bindings, so a single widget can display different images per round by updating screen.data. Browsers handle their own caching — the relay does not proxy.

C# factory

WidgetDefinitions.Image(
id: "prompt",
src: "https://cdn.example.com/prompts/{prompt_id}.png",
positionX: 0.5f, positionY: 0.4f,
sizeW: 0.6f, sizeH: 0.4f,
fit: "contain"
);

Wire format

FieldTypeRequiredNotes
idstringyes
type"image"yes
position_x, position_y, size_w, size_hnumberno0..1 anchor + size.
srcstringnoURL or {key}-templated URL.
altstringnoAccessibility text.
fit"cover" | "contain"noCSS object-fit. Default "contain".

Events

Display only.

Example

// Swap the image for the next round.
manager.UpdateScreenDataForAll("round", new { prompt_id = "round_2" });
// `src: "https://cdn.example.com/prompts/{prompt_id}.png"` now resolves to round_2.png.