Create a dictation session. The session object can be used more than once to get a transcription. When a transcription is received a buffer will be allocated to store the text in with a maximum size specified by buffer_size. When a transcription and accepted by the user or a failure of some sort occurs, the callback specified will be called with the status and the transcription if one was accepted.
size of buffer to allocate for the transcription text; text will be truncated if it is longer than the maximum size specified; a size of 0 will allow the session to allocate as much as it needs and text will not be truncated
dictation session status handler (must be valid)
context pointer for status handler
handle to the dictation session or NULL if the phone app is not connected or does not support voice dictation, if this is called on a platform that doesn't support voice dictation, or if an internal error occurs.
Destroy the dictation session and free its memory. Will terminate a session in progress.
dictation session to be destroyed
Start the dictation session. The dictation UI will be shown. When the user accepts a transcription or exits the UI, or, when the confirmation dialog is disabled and a status is received, the status callback will be called. Can only be called when no session is in progress. The session can be restarted multiple times after the UI is exited or the session is stopped.
dictation session to start or restart
true if session was started, false if session is already in progress or is invalid.
Stop the current dictation session. The UI will be hidden and no status callbacks will be received after the session is stopped.
dictation session to stop
true if session was stopped, false if session was not started or is invalid
Enable or disable user confirmation of transcribed text, which allows the user to accept or reject (and restart) the transcription. Must be called before the session is started.
dictation session to modify
set to true to enable user confirmation of transcriptions (default), false to disable
Enable or disable error dialogs when transcription fails. Must be called before the session is started. Disabling error dialogs will also disable automatic retries if transcription fails.
dictation session to modify
set to true to enable error dialogs (default), false to disable
Transcription successful, with a valid result.
User rejected transcription and exited UI.
User exited UI after transcription error.
Too many errors occurred during transcription and the UI exited.
No speech was detected and UI exited.
No BT or internet connection.
Voice transcription disabled for this user.
Voice transcription failed due to internal error.
Cloud recognizer failed to transcribe speech (only possible if error dialogs disabled)
Dictation status callback. Indicates success or failure of the dictation session and, if successful, passes the transcribed string to the user of the dictation session. The transcribed string will be freed after this call returns, so the string should be copied if it needs to be retained afterwards.
dictation session from which the status was received
dictation status
transcribed string
callback context specified when starting the session
Convenience macro to switch between two expressions depending on mic support. On platforms with a mic the first expression will be chosen, the second otherwise.
Convenience macro to switch between two expressions depending on mic support. On platforms with a mic the first expression will be chosen, the second otherwise.
Do you have questions about the Pebble SDK?
Do you need some help understanding something on this page?
You can either take advantage of our awesome developer community and check out the SDK Help forums, or you can send us a message through the website!