chrome.ttsEngine

Açıklama

İzinler

Kavramlar ve kullanım

Bir uzantı kendini bir konuşma motoru olarak kaydedebilir. Bu durumda, aramaların bazılarına veya tamamına karşılık gelebilir tts.speak() ve tts.stop() gibi işlevlere ekleyin ve alternatif bir uygulama sağlayın. Uzantılar, konuşma sağlamak için mevcut web teknolojilerinin (ses akışı da dahil) kullanımı ücretsizdir HTML5 sesten yararlanırız. Bir uzantı farklı bir şey bile yapabilir altyazıyı pop-up'ta görüntüleyebilir veya bunları günlük mesajı olarak uzak bir sunucuya bile götürebilir.

Bir TTS motorunu uygulamak için bir uzantının "ttsEngine" beyan edin ve ardından uzantı manifest'inde sağladığı sesler aşağıdaki gibidir:

{
  "name": "My TTS Engine",
  "version": "1.0",
  "permissions": ["ttsEngine"],
  "tts_engine": {
    "voices": [
      {
        "voice_name": "Alice",
        "lang": "en-US",
        "event_types": ["start", "marker", "end"]
      },
      {
        "voice_name": "Pat",
        "lang": "en-US",
        "event_types": ["end"]
      }
    ]
  },
  "background": {
    "page": "background.html",
    "persistent": false
  }
}

Bir uzantı herhangi bir sayıda ses belirtebilir.

voice_name parametresi zorunludur. Ad, kimlik bilgisini tanımlamaya yetecek kadar açıklayıcı olmalıdır sesin ve kullanılan motorun adı. Çok düşük bir ihtimal de olsa iki uzantının ses kaydettiği durumlarda bir istemci, sentezlemeyi yapması gereken uzantının kimliğini belirtebilir.

lang parametresi isteğe bağlıdır ancak kesinlikle önerilir. Ses, neredeyse her zaman tek bir dilde konuşma imkanı sağlar. Bir motor birden fazla dili desteklediğinde her dil için ayrı bir ses kaydedebilirsiniz. Tek bir sesin duyulabileceği nadir durumlarda birden fazla dili kullanıyorsanız, iki ayrı ses listelemek ve bunları şirket içinde de aynı mantık geçerlidir. Ancak, herhangi bir videodaki söylenenleri işleyecek bir ses oluşturmak dil ayarını kullanıyorsanız lang parametresini uzantınızın manifest dosyasından hariç tutun.

Son olarak, motor, istemciyi güncellemek için etkinlik gönderebiliyorsa event_types parametresi gerekir konuşma sentezinin ilerleme durumu üzerinde. En azından, 'end' etkinlik türünün desteklenmesi, kesinlikle önerilir. Aksi takdirde, Chrome sıraya alınan ifadeleri planlayamaz.

Yüklendikten sonra uzantılar, şunu çağırarak bildirilen seslerin listesini değiştirebilir: chrome.ttsEngine.updateVoices (programatik çağrıda kullanılan parametrelerin updateVoices büyük/küçük harf düzenindedir: ör. voiceName, voice_name) dokunun.

Gönderebileceğiniz olası etkinlik türleri, speak() yönteminin etkinleştirildiği etkinlik türlerine karşılık gelir. alır:

• 'start': Motor, söyleneni söylemeye başladı.
• 'word': Kelime sınırına ulaşıldı. Geçerli konuşmayı belirlemek için event.charIndex komutunu kullanın dokunun.
• 'sentence': Cümle sınırına ulaşıldı. Mevcut anahtar kelimeleri belirlemek için event.charIndex konuşma konumu.
• 'marker': Bir SSML işaretçisine ulaşıldı. Geçerli konuşmayı belirlemek için event.charIndex komutunu kullanın dokunun.
• 'end': Motor, söyleneni söylemeyi bitirdi.
• 'error': Motora özel bir hata oluştu ve bu söylenen sesli okunamıyor. Diğer kartları göster event.errorMessage içinde yer alan bilgiler.

'interrupted' ve 'cancelled' etkinlikleri konuşma motoru tarafından gönderilmez; oluşturuldukları için otomatik olarak Chrome tarafından sunulur.

Metin okuma istemcileri, telefon numarasını arayarak ses bilgilerini uzantınızın manifest dosyasından alabilir. tts.getVoices. Aşağıda açıklanan şekilde konuşma etkinliği işleyicileri kaydettiğiniz varsayılmıştır.

Konuşma etkinliklerini işleme

İstemcilerin isteği üzerine konuşma oluşturmak için uzantınız her ikisinde de dinleyicileri kaydetmelidir onSpeak ve onStop şöyle:

const speakListener = (utterance, options, sendTtsEvent) => {
  sendTtsEvent({type: 'start', charIndex: 0})

  // (start speaking)

  sendTtsEvent({type: 'end', charIndex: utterance.length})
};

const stopListener = () => {
  // (stop all speech)
};

chrome.ttsEngine.onSpeak.addListener(speakListener);
chrome.ttsEngine.onStop.addListener(stopListener);

Belirli bir konuşma isteğinin bir uzantıya gönderilip gönderilmeyeceğine sadece şuna karar verilir: uzantının manifest dosyasında belirtilen ses parametrelerini destekleyip desteklemediğini ve onSpeak ve onStop dinleyicileri. Başka bir deyişle, bir ek süre teklifinde ve dinamik olarak karar verir.

chrome.ttsEngine.updateVoices(
  voices: TtsVoice[],
)

chrome.ttsEngine.onPause.addListener(
  callback: function,
)

chrome.ttsEngine.onResume.addListener(
  callback: function,
)

chrome.ttsEngine.onSpeak.addListener(
  callback: function,
)

chrome.ttsEngine.onSpeakWithAudioStream.addListener(
  callback: function,
)

chrome.ttsEngine.onStop.addListener(
  callback: function,
)