Skip to main content

Autonomic

Picker group: Widgets · Project type: autonomic · Reference version: 27.0.29

Use Autonomic (autonomic) for an Autonomic media-player interface. Add Autonomic, then configure the player API base URL and the default player name. Choose whether to show the player selector and provide fallback artwork when needed.

Allocate enough space for the player controls and metadata. A working demonstration needs a reachable Autonomic service; an empty API URL is not a functional player configuration. Test player selection, metadata/artwork updates, and playback controls with the actual service.

Configure in the VS Code sidebar​

Select the Autonomic on the visual canvas, then open Element Properties. The screenshot shows the selected control in the development environment; click it to open the full-resolution image. Expand the groups below; scroll the sidebar to reach settings below the visible area.

Autonomic selected in VS Code with its Element Properties sidebar and visual canvas

Sidebar controlWhat it does
Content → Base URLEnter the reachable Autonomic API endpoint. The placeholder is an example, not a detected device.
Content → Default Player NameChoose the player that the widget should use initially.
Content → Hide Player SelectorHide player selection only when the interface should use the configured player.
Width / Height and AppearanceAllow space for artwork, metadata, and playback controls. The screenshot shows an unconnected editor example.

The shared Element name, datasource, sizing, CSS, and mode controls are explained in the sidebar reference. Settings depend on the selected type and variant.

Settings explained​

Select the control and open Element Properties. Expand the relevant sections for its variant, appearance, content, and actions. The property keys below identify the saved project settings; the visible groups vary by control and variant.

SettingProject propertyWhat to configure
API endpointautonomicBaseUrlBase URL of the reachable Autonomic player API.
Default playerautonomicDefaultPlayerNamePlayer/zone selected initially; use the actual service name.
Player selectorhidePlayerSelectorHide only when a fixed-zone interface is intended and the default player is valid.
Fallback artworkImage source propertiesArtwork used when a media image is unavailable.
Widget areawidth, heightAllow space for artwork, player selection, metadata, and playback controls.

Worked setup​

  1. Confirm the Autonomic service is reachable from the panel or browser that will run the interface.
  2. Insert Autonomic and name it MusicPlayer. Start with a tall area such as 380 × 470 px.
  3. Enter the API base URL and an existing default player/zone name.
  4. Keep the player selector visible while checking the available players. Hide it only for an intentional single-zone screen.
  5. Preview with the service online and test player selection, metadata, artwork, and playback controls.

The screenshot shows the widget with no API configured. The warning indicator and empty artwork are an unconnected state, not a completed player setup. No working Autonomic backend was used for this documentation capture.

Verify the result​

Confirm the selected zone, play/pause, previous/next where supported, and metadata/artwork updates. Test recovery after the service becomes unavailable and reachable again.

Save the project, run Run Project Health Check, and test in Open Live Preview (Browser). Hardware-backed behavior also needs verification in the target runtime with the actual integration available.