Card Features
Features and functionality index.
Ccard layout is comprised of a header, content, and footer areas.
-
Header : This area is used to display a title that represents the card as a whole (e.g. "My SoundTouch Info"). The header will not be shown if the title content is empty or not configured.
-
Content : This area is used to display selected section content.
-
Footer : This area is used to display section selection icons if multiple sections of the card are enabled. The footer will not be shown if only one section is selected.
Sections are enabled / disabled via Card Configuration.
Multiple sections can be enabled in the card, but only one section is displayed at a time in the content area. A section is selected for display by clicking on its icon located in the footer area. In most cases, the section content is refreshed when you switch to the section.
A single section can be enabled in the card, which will only show content for that section.This configuration allows you to show the different sections next to each other (in a horizontal stack lets say) by adding multiple instances of the card with different sections enabled.
By default, the Presets and Recently Played sections of the card are enabled.
The following is a detailed explanation of the individual sections.
You must have the Pandora Music Service configured on the SoundTouch device in order for the card to access Pandora. The Pandora Music Service can be added and configured via the Bose SoundTouch App.
The card accesses Pandora via the SoundTouch device - there is no direct communication from the card to Pandora. The SoundTouch device limits you to one Pandora account per device, so you must use THAT account when accessing Pandora.
Pandora Stations are retrieved from the SoundTouch device using the PANDORA source. The stations are retrieved in real time by the device (not cached), so any stations you just added via the web or mobile player should show up immediately upon the next refresh of the list.
Pandora Stations are presented to the user in a Media Browser format. An item may be selected for play immediately by clicking on the item.
Most of the various section displays in the card utilize a media browser for displaying media content items. This media browser functionality is similar to the Home Assistant Media Browser functionality in how it looks, but it behaves a little bit differently under the covers.
Here are a few features of the media browser:
-
supports item click functionality to play the given content. The item is immediately selected for play once it is clicked.
-
supports item click and hold functionality for some section types. For example, the Presets media browser allows a preset to be set to the currently playing media by clicking and holding the preset slot item for @ 2 seconds.
-
supports both icon (see Figure 1a) and list (see Figure 1b) formats. For the icon format, the number of icons in the row is configurable. The size of the icons is also responsive, in that they will expand / shrink in size to fill the available space.
-
supports custom image url's based on the track title, so that you can manually override the image that is displayed for a named track if you like. This also works well for recently played items, as the SoundTouch device automatically removes cover art image url's from the recently played list due to copyright agreements with the various music services.
Figure 1a - Media Items Icon Format
Figure 1b - Media Items List Format
