Comment on page
Message Types
Messages are used to communicate information between Mycroft services and other components. This list of Message types outlines the details and provides sample code for each.
Each Message type listed contains a description outlining it's meaning or purpose. Where relevant, the Message type will also list the specific JSON data packets expected to be emitted with that Message, and the most common producers and consumers of the Message.
See the MessageBus documentation for further information on this service and examples of using Messages.
Request to speak utterance
Data:
{
"utterance": <words to be spoken>,
"lang": <language code, e.g. en-us>
}
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('speak',
self.handler_speak)
def handler_speak(self, message):
# code to excecute when speak message detected...
...
...
def some_method(self):
self.bus.emit(Message('speak',
{"utterance": <words to be spoken>,
"lang": <language code, e.g. en-us>}))
...
python3 -m mycroft.messagebus.send 'speak' '{ "utterance": <words to be spoken>, "lang": <language code, e.g. en-us>}'
Internet connection is now available (only generated on initial connection)
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.internet.connected',
self.handler_mycroft_internet_connected)
def handler_mycroft_internet_connected(self, message):
# code to excecute when mycroft.internet.connected message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.internet.connected'))
...
python3 -m mycroft.messagebus.send 'mycroft.internet.connected'
Sent by start-up sequence when everything is ready for user interaction
Producer | Consumer |
skills/padatious_service.py | Pairing Skill |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.ready',
self.handler_mycroft_ready)
def handler_mycroft_ready(self, message):
# code to excecute when mycroft.ready message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.ready'))
...
python3 -m mycroft.messagebus.send 'mycroft.ready'
Stop command (e.g. button pressed)
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.stop',
self.handler_mycroft_stop)
def handler_mycroft_stop(self, message):
# code to excecute when mycroft.stop message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.stop'))
...
python3 -m mycroft.messagebus.send 'mycroft.stop'
Start the pairing process when this event is emitted.
Producer | Consumer |
Pairing Skill Weather Skill Wolfram Alpha Skill | Pairing Skill |
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.not.paired',
self.handler_mycroft_not_paired)
def handler_mycroft_not_paired(self, message):
# code to excecute when mycroft.not.paired message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.not.paired'))
...
python3 -m mycroft.messagebus.send 'mycroft.not.paired'
Pairing has completed
Producer | Consumer |
Pairing Skill | skills/skill_manager.py enclosure/mark1/__init__.py enclosure/generic/__init__.py client/speech/__main__.py |
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.paired',
self.handler_mycroft_paired)
def handler_mycroft_paired(self, message):
# code to excecute when mycroft.paired message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.paired'))
...
python3 -m mycroft.messagebus.send 'mycroft.paired'
Has come out of sleep mode
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.awoken',
self.handler_mycroft_awoken)
def handler_mycroft_awoken(self, message):
# code to excecute when mycroft.awoken message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.awoken'))
...
python3 -m mycroft.messagebus.send 'mycroft.awoken'
log level can be: "CRITICAL" "ERROR" "WARNING" "INFO" "DEBUG" These correspond to the Python logging object.
The "bus" parameter allows turning the logging of all bus messages on/off.
Data:
{
"level" : <log level>,
"bus": <True/False>
}
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.debug.log',
self.handler_mycroft_debug_log)
def handler_mycroft_debug_log(self, message):
# code to excecute when mycroft.debug.log message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.debug.log',
{
"level" : <log level>,
"bus": <True/False>}))
...
python3 -m mycroft.messagebus.send 'mycroft.debug.log' '{ "level" : <log level>, "bus": <True/False>}'
Intent processing failed
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('complete_intent_failure',
self.handler_complete_intent_failure)
def handler_complete_intent_failure(self, message):
# code to excecute when complete_intent_failure message detected...
...
...
def some_method(self):
self.bus.emit(Message('complete_intent_failure'))
...
python3 -m mycroft.messagebus.send 'complete_intent_failure'
Notification to services that the configuration has changed and needs reloaded
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('configuration.updated',
self.handler_configuration_updated)
def handler_configuration_updated(self, message):
# code to excecute when configuration.updated message detected...
...
...
def some_method(self):
self.bus.emit(Message('configuration.updated'))
...
python3 -m mycroft.messagebus.send 'configuration.updated'
Wakeword was heard
Data:
{
"utterance": <wakeword heard>,
"session": <session ID>,
}
Producer | Consumer |
client/speech/main.py | |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:wakeword',
self.handler_wakeword)
def handler_wakeword(self, message):
# code to excecute when recognizer_loop:wakeword message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:wakeword',
{"utterance": <wakeword heard>,
"session": <session ID>,}
))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:wakeword' '{ "utterance": <wakeword heard>, "session": <session ID>,}'
Recording has started
Producer | Consumer |
client/speech/main.py | |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:record_begin',
self.handler_record_begin)
def handler_record_begin(self, message):
# code to excecute when recognizer_loop:record_begin message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:record_begin'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:record_begin'
Recording has ended
Producer | Consumer |
client/speech/main.py | |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:record_end',
self.handler_record_end)
def handler_record_end(self, message):
# code to excecute when recognizer_loop:record_end message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:record_end'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:record_end'
STT has detected the given text or text was injected as an utterance via the CLI.
Data:
{
"utterances": [text],
"lang": self.stt.lang,
"session": session_id
}
Producer | Consumer |
client/speech/__main__.py client/speech/listener.py client/text/text_client.py skills/__main__.py | client/text/text_client.py messagebus/client/client.py skills/intent_service.py |
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:utterance',
self.handler_utterance)
def handler_utterance(self, message):
# code to excecute when recognizer_loop:utterance message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:utterance',
{"utterances": [text],
"lang": self.stt.lang,
"session": session_id}))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:utterance' '{ "utterances": [text], "lang": self.stt.lang, "session": session_id}'
Text output (TTS) has begun
Producer | Consumer |
audio/speech.py | |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:audio_output_start',
self.handler_audio_output_start)
def handler_audio_output_start(self, message):
# code to excecute when recognizer_loop:audio_output_start message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:audio_output_start'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:audio_output_start'
Text output (TTS) has ended
Producer | Consumer |
audio/speech.py | |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:audio_output_end',
self.handler_audio_output_end)
def handler_audio_output_end(self, message):
# code to excecute when recognizer_loop:audio_output_end message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:audio_output_end'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:audio_output_end'
Go into "sleep" mode. Everything except "Hey Mycroft, wake up" will be ignored.
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:sleep',
self.handler_sleep)
def handler_sleep(self, message):
# code to excecute when recognizer_loop:sleep message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:sleep'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:sleep'
Come out of "sleep" mode.
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:wake_up',
self.handler_wake_up)
def handler_wake_up(self, message):
# code to excecute when recognizer_loop:wake_up message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:wake_up'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:wake_up'
Detected a connection error during STT
Producer | Consumer |
audio/speech.py | |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('enclosure.notify.no_internet',
self.handler_enclosure_notify_no_internet)
def handler_enclosure_notify_no_internet(self, message):
# code to excecute when enclosure.notify.no_internet message detected...
...
...
def some_method(self):
self.bus.emit(Message('enclosure.notify.no_internet'))
...
python3 -m mycroft.messagebus.send 'enclosure.notify.no_internet'
start: timestamp for audio starts (unix epoch) END_TIME: time in seconds from "start" until the end of the viseme CODE can be 0 = shape for sounds like 'y' or 'aa' 1 = shape for sounds like 'aw' 2 = shape for sounds like 'uh' or 'r' 3 = shape for sounds like 'th' or 'sh' 4 = neutral shape for no sound 5 = shape for sounds like 'f' or 'v' 6 = shape for sounds like 'oy' or 'ao'
Data:
{
"start": timestamp,
"visemes": [[CODE,END_TIME],...]
}
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('enclosure.mouth.viseme_list',
self.handler_enclosure_mouth_viseme_list)
def handler_enclosure_mouth_viseme_list(self, message):
# code to excecute when enclosure.mouth.viseme_list message detected...
...
...
def some_method(self):
self.bus.emit(Message('enclosure.mouth.viseme_list',
{
"start": timestamp,
"visemes": [[CODE,END_TIME],...]}))
...
python3 -m mycroft.messagebus.send 'enclosure.mouth.viseme_list' '{ "start": timestamp, "visemes": [[CODE,END_TIME],...]}'
Change eyes to default color
Producer | Consumer |
| mycroft-mark-1 |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.eyes.default',
self.handler_mycroft_eyes_default)
def handler_mycroft_eyes_default(self, message):
# code to excecute when mycroft.eyes.default message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.eyes.default'))
...
python3 -m mycroft.messagebus.send 'mycroft.eyes.default'
Begin recording for STT processing
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.mic.listen',
self.handler_mycroft_mic_listen)
def handler_mycroft_mic_listen(self, message):
# code to excecute when mycroft.mic.listen message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.mic.listen'))
...
python3 -m mycroft.messagebus.send 'mycroft.mic.listen'
Turn off the mic (no wakeword or STT processing)
Producer | Consumer |
Pairing Skill | client/speech/main.py |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.mic.mute',
self.handler_mycroft_mic_mute)
def handler_mycroft_mic_mute(self, message):
# code to excecute when mycroft.mic.mute message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.mic.mute'))
...
python3 -m mycroft.messagebus.send 'mycroft.mic.mute'
Turn on the mic (enable wakeword and STT processing)
Producer | Consumer |
Pairing Skill | client/speech/main.py |
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.mic.unmute',
self.handler_mycroft_mic_unmute)
def handler_mycroft_mic_unmute(self, message):
# code to excecute when mycroft.mic.unmute message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.mic.unmute'))
...
python3 -m mycroft.messagebus.send 'mycroft.mic.unmute'
Start playback of tracklist
Producer | Consumer |
skills/audioservice.py playback-control | audio/main.py |
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.audio.service.play',
self.handler_mycroft_audio_service_play)
def handler_mycroft_audio_service_play(self, message):
# code to excecute when mycroft.audio.service.play message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.audio.service.play'))
...
python3 -m mycroft.messagebus.send 'mycroft.audio.service.play'
Stop playback
Producer | Consumer |
skills/audioservice.py playback-control | audio/main.py |
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):