2023-01-05 20:25:55 +08:00
|
|
|
/**************************************************************************/
|
|
|
|
/* tts_linux.cpp */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/**************************************************************************/
|
2021-11-04 20:33:37 +08:00
|
|
|
|
|
|
|
#include "tts_linux.h"
|
|
|
|
|
|
|
|
#include "core/config/project_settings.h"
|
|
|
|
#include "servers/text_server.h"
|
|
|
|
|
|
|
|
TTS_Linux *TTS_Linux::singleton = nullptr;
|
|
|
|
|
|
|
|
void TTS_Linux::speech_init_thread_func(void *p_userdata) {
|
|
|
|
TTS_Linux *tts = (TTS_Linux *)p_userdata;
|
|
|
|
if (tts) {
|
|
|
|
MutexLock thread_safe_method(tts->_thread_safe_);
|
2023-02-15 20:13:56 +08:00
|
|
|
#ifdef SOWRAP_ENABLED
|
2021-11-04 20:33:37 +08:00
|
|
|
#ifdef DEBUG_ENABLED
|
|
|
|
int dylibloader_verbose = 1;
|
|
|
|
#else
|
|
|
|
int dylibloader_verbose = 0;
|
|
|
|
#endif
|
2023-02-15 20:13:56 +08:00
|
|
|
if (initialize_speechd(dylibloader_verbose) != 0) {
|
|
|
|
print_verbose("Text-to-Speech: Cannot load Speech Dispatcher library!");
|
|
|
|
} else {
|
2023-03-16 16:44:47 +08:00
|
|
|
if (!spd_open || !spd_set_notification_on || !spd_list_synthesis_voices || !free_spd_voices || !spd_set_synthesis_voice || !spd_set_volume || !spd_set_voice_pitch || !spd_set_voice_rate || !spd_set_data_mode || !spd_say || !spd_pause || !spd_resume || !spd_cancel) {
|
|
|
|
// There's no API to check version, check if functions are available instead.
|
|
|
|
print_verbose("Text-to-Speech: Unsupported Speech Dispatcher library version!");
|
|
|
|
return;
|
|
|
|
}
|
2023-02-15 20:13:56 +08:00
|
|
|
#else
|
|
|
|
{
|
|
|
|
#endif
|
2021-11-04 20:33:37 +08:00
|
|
|
CharString class_str;
|
|
|
|
String config_name = GLOBAL_GET("application/config/name");
|
|
|
|
if (config_name.length() == 0) {
|
|
|
|
class_str = "Godot_Engine";
|
|
|
|
} else {
|
|
|
|
class_str = config_name.utf8();
|
|
|
|
}
|
|
|
|
tts->synth = spd_open(class_str, "Godot_Engine_Speech_API", "Godot_Engine", SPD_MODE_THREADED);
|
|
|
|
if (tts->synth) {
|
|
|
|
tts->synth->callback_end = &speech_event_callback;
|
|
|
|
tts->synth->callback_cancel = &speech_event_callback;
|
|
|
|
tts->synth->callback_im = &speech_event_index_mark;
|
|
|
|
spd_set_notification_on(tts->synth, SPD_END);
|
|
|
|
spd_set_notification_on(tts->synth, SPD_CANCEL);
|
|
|
|
|
|
|
|
print_verbose("Text-to-Speech: Speech Dispatcher initialized.");
|
|
|
|
} else {
|
|
|
|
print_verbose("Text-to-Speech: Cannot initialize Speech Dispatcher synthesizer!");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void TTS_Linux::speech_event_index_mark(size_t p_msg_id, size_t p_client_id, SPDNotificationType p_type, char *p_index_mark) {
|
|
|
|
TTS_Linux *tts = TTS_Linux::get_singleton();
|
2023-02-21 16:45:49 +08:00
|
|
|
if (tts) {
|
2023-10-27 02:37:15 +08:00
|
|
|
callable_mp(tts, &TTS_Linux::_speech_index_mark).call_deferred((int)p_msg_id, (int)p_type, String::utf8(p_index_mark));
|
2023-02-21 16:45:49 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-10-27 02:37:15 +08:00
|
|
|
void TTS_Linux::_speech_index_mark(int p_msg_id, int p_type, const String &p_index_mark) {
|
2023-02-21 16:45:49 +08:00
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
|
|
|
if (ids.has(p_msg_id)) {
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_BOUNDARY, ids[p_msg_id], p_index_mark.to_int());
|
2021-11-04 20:33:37 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void TTS_Linux::speech_event_callback(size_t p_msg_id, size_t p_client_id, SPDNotificationType p_type) {
|
|
|
|
TTS_Linux *tts = TTS_Linux::get_singleton();
|
|
|
|
if (tts) {
|
2023-10-27 02:37:15 +08:00
|
|
|
callable_mp(tts, &TTS_Linux::_speech_event).call_deferred((int)p_msg_id, (int)p_type);
|
2023-02-21 16:45:49 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2024-07-30 12:23:12 +08:00
|
|
|
void TTS_Linux::_load_voices() const {
|
2023-06-02 19:00:52 +08:00
|
|
|
if (!voices_loaded) {
|
|
|
|
SPDVoice **spd_voices = spd_list_synthesis_voices(synth);
|
|
|
|
if (spd_voices != nullptr) {
|
|
|
|
SPDVoice **voices_ptr = spd_voices;
|
|
|
|
while (*voices_ptr != nullptr) {
|
|
|
|
VoiceInfo vi;
|
|
|
|
vi.language = String::utf8((*voices_ptr)->language);
|
|
|
|
vi.variant = String::utf8((*voices_ptr)->variant);
|
|
|
|
voices[String::utf8((*voices_ptr)->name)] = vi;
|
|
|
|
voices_ptr++;
|
|
|
|
}
|
|
|
|
free_spd_voices(spd_voices);
|
|
|
|
}
|
|
|
|
voices_loaded = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-10-27 02:37:15 +08:00
|
|
|
void TTS_Linux::_speech_event(int p_msg_id, int p_type) {
|
2023-02-21 16:45:49 +08:00
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
|
|
|
if (!paused && ids.has(p_msg_id)) {
|
|
|
|
if ((SPDNotificationType)p_type == SPD_EVENT_END) {
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_ENDED, ids[p_msg_id]);
|
|
|
|
ids.erase(p_msg_id);
|
|
|
|
last_msg_id = -1;
|
|
|
|
speaking = false;
|
|
|
|
} else if ((SPDNotificationType)p_type == SPD_EVENT_CANCEL) {
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_CANCELED, ids[p_msg_id]);
|
|
|
|
ids.erase(p_msg_id);
|
|
|
|
last_msg_id = -1;
|
|
|
|
speaking = false;
|
2021-11-04 20:33:37 +08:00
|
|
|
}
|
2023-02-21 16:45:49 +08:00
|
|
|
}
|
|
|
|
if (!speaking && queue.size() > 0) {
|
|
|
|
DisplayServer::TTSUtterance &message = queue.front()->get();
|
|
|
|
|
|
|
|
// Inject index mark after each word.
|
|
|
|
String text;
|
|
|
|
String language;
|
2023-06-02 19:00:52 +08:00
|
|
|
|
|
|
|
_load_voices();
|
|
|
|
const VoiceInfo *voice = voices.getptr(message.voice);
|
|
|
|
if (voice) {
|
|
|
|
language = voice->language;
|
2023-02-21 16:45:49 +08:00
|
|
|
}
|
2023-06-02 19:00:52 +08:00
|
|
|
|
2023-02-21 16:45:49 +08:00
|
|
|
PackedInt32Array breaks = TS->string_get_word_breaks(message.text, language);
|
2023-07-05 17:49:16 +08:00
|
|
|
int prev_end = -1;
|
2023-02-21 16:45:49 +08:00
|
|
|
for (int i = 0; i < breaks.size(); i += 2) {
|
|
|
|
const int start = breaks[i];
|
|
|
|
const int end = breaks[i + 1];
|
2023-07-05 17:49:16 +08:00
|
|
|
if (prev_end != -1 && prev_end != start) {
|
|
|
|
text += message.text.substr(prev_end, start - prev_end);
|
|
|
|
}
|
|
|
|
text += message.text.substr(start, end - start);
|
2023-02-21 16:45:49 +08:00
|
|
|
text += "<mark name=\"" + String::num_int64(end, 10) + "\"/>";
|
2023-07-05 17:49:16 +08:00
|
|
|
prev_end = end;
|
2023-02-21 16:45:49 +08:00
|
|
|
}
|
2023-07-05 17:49:16 +08:00
|
|
|
|
2023-02-21 16:45:49 +08:00
|
|
|
spd_set_synthesis_voice(synth, message.voice.utf8().get_data());
|
|
|
|
spd_set_volume(synth, message.volume * 2 - 100);
|
|
|
|
spd_set_voice_pitch(synth, (message.pitch - 1) * 100);
|
|
|
|
float rate = 0;
|
|
|
|
if (message.rate > 1.f) {
|
|
|
|
rate = log10(MIN(message.rate, 2.5f)) / log10(2.5f) * 100;
|
|
|
|
} else if (message.rate < 1.f) {
|
|
|
|
rate = log10(MAX(message.rate, 0.5f)) / log10(0.5f) * -100;
|
2021-11-04 20:33:37 +08:00
|
|
|
}
|
2023-02-21 16:45:49 +08:00
|
|
|
spd_set_voice_rate(synth, rate);
|
|
|
|
spd_set_data_mode(synth, SPD_DATA_SSML);
|
|
|
|
last_msg_id = spd_say(synth, SPD_TEXT, text.utf8().get_data());
|
|
|
|
ids[last_msg_id] = message.id;
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_STARTED, message.id);
|
|
|
|
|
|
|
|
queue.pop_front();
|
|
|
|
speaking = true;
|
2021-11-04 20:33:37 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
bool TTS_Linux::is_speaking() const {
|
|
|
|
return speaking;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool TTS_Linux::is_paused() const {
|
|
|
|
return paused;
|
|
|
|
}
|
|
|
|
|
|
|
|
Array TTS_Linux::get_voices() const {
|
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
2023-09-09 23:46:44 +08:00
|
|
|
ERR_FAIL_NULL_V(synth, Array());
|
2024-07-30 12:23:12 +08:00
|
|
|
_load_voices();
|
2023-06-02 19:00:52 +08:00
|
|
|
|
2021-11-04 20:33:37 +08:00
|
|
|
Array list;
|
2023-06-02 19:00:52 +08:00
|
|
|
for (const KeyValue<String, VoiceInfo> &E : voices) {
|
|
|
|
Dictionary voice_d;
|
|
|
|
voice_d["name"] = E.key;
|
|
|
|
voice_d["id"] = E.key;
|
|
|
|
voice_d["language"] = E.value.language + "_" + E.value.variant;
|
|
|
|
list.push_back(voice_d);
|
2021-11-04 20:33:37 +08:00
|
|
|
}
|
2023-06-02 19:00:52 +08:00
|
|
|
|
2021-11-04 20:33:37 +08:00
|
|
|
return list;
|
|
|
|
}
|
|
|
|
|
|
|
|
void TTS_Linux::speak(const String &p_text, const String &p_voice, int p_volume, float p_pitch, float p_rate, int p_utterance_id, bool p_interrupt) {
|
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
2023-09-09 23:46:44 +08:00
|
|
|
ERR_FAIL_NULL(synth);
|
2021-11-04 20:33:37 +08:00
|
|
|
if (p_interrupt) {
|
|
|
|
stop();
|
|
|
|
}
|
|
|
|
|
|
|
|
if (p_text.is_empty()) {
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_CANCELED, p_utterance_id);
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
DisplayServer::TTSUtterance message;
|
|
|
|
message.text = p_text;
|
|
|
|
message.voice = p_voice;
|
|
|
|
message.volume = CLAMP(p_volume, 0, 100);
|
|
|
|
message.pitch = CLAMP(p_pitch, 0.f, 2.f);
|
|
|
|
message.rate = CLAMP(p_rate, 0.1f, 10.f);
|
|
|
|
message.id = p_utterance_id;
|
|
|
|
queue.push_back(message);
|
|
|
|
|
|
|
|
if (is_paused()) {
|
|
|
|
resume();
|
|
|
|
} else {
|
2023-10-27 02:37:15 +08:00
|
|
|
_speech_event(0, (int)SPD_EVENT_BEGIN);
|
2021-11-04 20:33:37 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void TTS_Linux::pause() {
|
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
2023-09-09 23:46:44 +08:00
|
|
|
ERR_FAIL_NULL(synth);
|
2021-11-04 20:33:37 +08:00
|
|
|
if (spd_pause(synth) == 0) {
|
|
|
|
paused = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void TTS_Linux::resume() {
|
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
2023-09-09 23:46:44 +08:00
|
|
|
ERR_FAIL_NULL(synth);
|
2021-11-04 20:33:37 +08:00
|
|
|
spd_resume(synth);
|
|
|
|
paused = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
void TTS_Linux::stop() {
|
|
|
|
_THREAD_SAFE_METHOD_
|
|
|
|
|
2023-09-09 23:46:44 +08:00
|
|
|
ERR_FAIL_NULL(synth);
|
2021-11-04 20:33:37 +08:00
|
|
|
for (DisplayServer::TTSUtterance &message : queue) {
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_CANCELED, message.id);
|
|
|
|
}
|
|
|
|
if ((last_msg_id != -1) && ids.has(last_msg_id)) {
|
|
|
|
DisplayServer::get_singleton()->tts_post_utterance_event(DisplayServer::TTS_UTTERANCE_CANCELED, ids[last_msg_id]);
|
|
|
|
}
|
|
|
|
queue.clear();
|
|
|
|
ids.clear();
|
|
|
|
last_msg_id = -1;
|
|
|
|
spd_cancel(synth);
|
|
|
|
spd_resume(synth);
|
|
|
|
speaking = false;
|
|
|
|
paused = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
TTS_Linux *TTS_Linux::get_singleton() {
|
|
|
|
return singleton;
|
|
|
|
}
|
|
|
|
|
|
|
|
TTS_Linux::TTS_Linux() {
|
|
|
|
singleton = this;
|
|
|
|
// Speech Dispatcher init can be slow, it might wait for helper process to start on background, so run it in the thread.
|
|
|
|
init_thread.start(speech_init_thread_func, this);
|
|
|
|
}
|
|
|
|
|
|
|
|
TTS_Linux::~TTS_Linux() {
|
|
|
|
init_thread.wait_to_finish();
|
|
|
|
if (synth) {
|
|
|
|
spd_close(synth);
|
|
|
|
}
|
|
|
|
|
|
|
|
singleton = nullptr;
|
|
|
|
}
|