Audio Service

Search…

Audio Service

The audio service handles playback and queueing of tracks.

The mycroft-core distribution of Mycroft includes a Playback Skill which can be used to control playback after it has been started. This means that playback only needs to be started in the Skill. Controlling playback can then be done through the Playback Skill.
How to set up the Audio Service
First, import the
AudioService
class.
1
from mycroft.skills.audioservice import AudioService
Copied!
Then in the initialize() method of your Skill, instantiate an AudioService object:
1
    def initialize(self):
2
        self.audio_service = AudioService(self.bus)
3
​
4
        #Other initialize code
5
        [...]
Copied!
Starting playback
Once the AudioService instance is created, you can start playback by simply calling the play() method with a track URI:
1
        self.audio_service.play('file:///path/to/my/track.mp3')
Copied!
or with a list of tracks
1
        self.audio_service.play(['file:///path/to/my/track.mp3', 'http://tracks-online.com/my/track.mp3'])
Copied!
see the AudioServicePlugins for information about configuring supported uris.
The play method has an optional second argument to further process the user's Utterance. Currently this can only be used to select backend (where you want to send the audio) but in the future it will be able to handle requests like
Hey Mycroft, play Hello Nasty by the Beastie Boys at half volume. We don't want to wake the neighbours
To use this feature the Utterance received from the intent service must be passed
1
    def play_playlist_handler(self, message):
2
        self.audioservice.play(PLAYLIST, message.data['utterance'])
Copied!
More technical information
The backends
The default backend is still mpg123 for mp3 files which is very limited but is the most generally available or multiple platforms.
Included in this release there's also
VLC (a very general purpose media player)
mopidy (a common audio server in the Raspberry Pi community)
chromecast (experimental)
These haven't been extensively tested on the Mark 1 yet.
PulseAudio features
The audio service hooks into the PulseAudio controls and can mute playback of sound streams beyond Mycroft's control. This is currently deactivated by default but can be enabled by changing the mycroft.conf configuration found in mycroft/configuration/mycroft.conf
1
  "play_wav_cmdline": "paplay %1 --stream-name=mycroft-voice",
2
  "Audio": {
3
    "pulseaudio": "mute"
4
  }
Copied!
AudioService Technical Documentation
More information on AudioService methods can be found in the Mycroft Technical Documentation.

Voice Service

Skills Service

Last modified 1yr ago

Copy link

Contents

How to set up the Audio Service

Starting playback

More technical information

The backends

PulseAudio features

AudioService Technical Documentation