media-response.md

Platform Specific Features > Google Assistant > Media Response

Learn how to use the Google Action Media Response with Jovo.

• Introduction
• Features
  • Play a File
• Directives

Introduction

The Google Action Media Response allows you to play audio content, which is longer than 120 seconds. While using the Media Response you loose control of the stop, cancel and resume commands, since Google handles these themselves, without your app even receiving the request.

You can check out the official documentation here.

Features

Play a File

// Adds audio file to the response
this.googleAction().audioPlayer().play(url, name);

To send the response you can use either tell() or ask(), which have both different use cases.

this.googleAction().audioPlayer().play('https://www.url.to/file.mp3', 'song one');
this.tell('Enjoy the song!');

If you use tell() it will be handled as a final response and you wont receive a callback that the audio playback is completed.

The ask() method on the other hand will keep the session open so you can receive the callback, but it forces you to add Suggestion Chips to your response.

this.googleAction().audioPlayer().play('https://www.url.to/file.mp3', 'song one');
this.googleAction().showSuggestionChips(['Chip 1', 'Chip 2']);
this.ask('Enjoy the song');

Directive

The callback after the audio playback is finished will be mapped to the GoogleAction.Finished intent, which has to be placed in either the 'MEDIARESPONSE' or the 'AUDIOPLAYER' directive of your handler.

'MEDIARESPONSE': {
  'GoogleAction.Finished': function() { 
    // ...
  },
},

You can also use the 'AUDIOPLAYER' directive for cross-platform compatibility with the Alexa Audioplayer:

'AUDIOPLAYER': {
  'GoogleAction.Finished': function() { 
    // ...
  },
},