Bixby Developer Center

Guides
References

Podcast Capsule

The Podcast Capsule Template creates a capsule dedicated to a single or multiple RSS podcast feeds.

Creating a Podcast Capsule

Select the template in Bixby Developer Studio (Bixby Studio).

Podcast Capsule Entry Page

  1. Choose the language for your capsule.
  2. Click Next Step. Podcast Capsule Template, Page 2
  3. In the RSS Feed URL field, enter the URL for your podcast.
  4. [Optional] Click on the Add Feed button to add more RSS Feeds.
  5. Click Add Tag to add tags for each feed that corresponds to commonly used search terms.
    Note

    You only need to add tags if you have multiple RSS feeds. Tags give users the ability to play the different RSS feeds. For the example above, users could say "Play sample 1" or "Play sample 2" to differentiate between the feeds.

    For a single RSS feed, tags are optional.

  6. Set a Default Order that the episodes should play in.
  7. Click Next Step. Podcast Capsule Template, Page 3
  8. Enter a capsule ID for your new capsule, such as playground.dadJokes.
  9. Select a path and filename for the new capsule (or accept Bixby Studio's suggested default).
  10. Click Generate Capsule.

The capsule will be created for you in Bixby Studio, and a README file will be opened suggesting next steps and customizations.

By default, the capsule has training for the utterance "Play", which will start playing the most recent episode of the podcast, and it will use the image defined in the RSS feed as the channel's image. (Note that the player will not switch images for each individual episode, even if they are defined in the feed's items.) The playlist will be ordered from most recent to oldest, unless you specify a different default order.

Handling "Play Something Else" Utterance

Currently, if users are playing a podcast and then ask Bixby something like "play something else", the template has this utterance trained to the PlaySomethingElseNoAction action. This will throw an error dialog, letting users know that the action is not currently supported. For more information on no action handlers, see the Create No Action Handler in the categories documentation.

Default flow of podcast template if users ask "play something else"

You can learn about how to change this flow in the following Single Podcast and Multiple Podcast sections.

Single Podcast

If you have a single podcast, you can simply choose to continue playing the podcast, to indicate to users that only a single podcast is available.

Diagram of single podcast handling if users ask "play something else"

Alternatively, you can edit the No Action handler to let users know that only one podcast is available in your capsule.

Multiple Podcasts

If you have multiple podcasts, you have several options on how to handle this utterance.

Diagram of developer options for multiple podcasts handling if users ask "play something else"

  • [Recommended] Enable selection learning in your capsule and prompt the user to choose a new podcast to play. Over time, Bixby will learn which stream to play and automatically try to play that podcast instead.
  • Always prompt users to choose which podcast to play.
  • Use the currently playing context, if any, to select a different podcast using the order of podcasts defined when generating a capsule from this template. See code/lib/feeds.js for the order defined in the template.