chrome.ttsEngine

คำอธิบาย

สิทธิ์

แนวคิดและการใช้งาน

ส่วนขยายสามารถลงทะเบียนตัวเองเป็นเครื่องมืออ่านออกเสียงได้ วิธีนี้จะช่วยสกัดกั้นการโทรบางส่วนหรือทั้งหมด ให้กับฟังก์ชัน เช่น tts.speak() และ tts.stop() และระบุการติดตั้งใช้งานเพิ่มเติม ส่วนขยายมีอิสระในการใช้เทคโนโลยีเว็บใดๆ ที่มีเพื่อนำเสนอเสียงพูดรวมถึงการสตรีมเสียง จากเซิร์ฟเวอร์ ซึ่งก็คือเสียง HTML5 ส่วนขยายอาจทำอย่างอื่น พร้อมคำพูด เช่น แสดงคำบรรยายในป๊อปอัป หรือส่งเป็นข้อความบันทึกถึง เซิร์ฟเวอร์ระยะไกล

ในการใช้งานเครื่องมือ TTS ส่วนขยายต้องประกาศ "ttsEngine" แล้วประกาศทั้งหมด เสียงที่ใส่ในไฟล์ Manifest ของส่วนขยาย ดังนี้

{
  "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
  }
}

ส่วนขยายสามารถระบุจำนวนเสียงใดๆ ก็ได้

ต้องระบุพารามิเตอร์ voice_name ชื่อควรสื่อความหมายมากพอจนระบุถึง ของเสียงและเครื่องมือที่ใช้ ในกรณีที่ไม่น่าจะเกิดขึ้นที่ส่วนขยาย 2 รายการจะลงทะเบียนเสียง ด้วยชื่อเดียวกัน ไคลเอ็นต์สามารถระบุรหัสของส่วนขยายที่ควรทำการสังเคราะห์

พารามิเตอร์ lang เป็นพารามิเตอร์ที่ไม่บังคับ แต่ขอแนะนำอย่างยิ่ง โดยเสียงสามารถสังเคราะห์เสียงได้เกือบทุกครั้ง โดยใช้ภาษาเดียว เมื่อเครื่องมือสนับสนุนมากกว่า 1 ภาษา ก็สามารถ ลงทะเบียนเสียงแยกสำหรับแต่ละภาษา ภายใต้สถานการณ์ซึ่งพบได้ไม่บ่อยนัก ที่เสียงเดียวกันอาจ จัดการภาษาได้มากกว่า 1 ภาษา วิธีที่ง่ายที่สุดคือระบุเสียง 2 เสียงแยกกันและจัดการโดยใช้ ใช้ตรรกะเดียวกันเป็นการภายใน แต่ถ้าต้องการสร้างเสียงพูดที่จะจัดการคำพูดใน ภาษา ให้นำพารามิเตอร์ lang ออกจากไฟล์ Manifest ของส่วนขยาย

สุดท้าย ต้องมีพารามิเตอร์ event_types หากเครื่องมือส่งเหตุการณ์เพื่ออัปเดตไคลเอ็นต์ได้ เกี่ยวกับความคืบหน้าของการสังเคราะห์เสียง อย่างน้อยที่สุด ควรรองรับประเภทเหตุการณ์ 'end' เพื่อระบุว่า ขอแนะนำให้ใช้เมื่อเสียงพูดเสร็จสิ้น มิเช่นนั้น Chrome จะไม่สามารถกำหนดเวลาการพูดที่อยู่ในคิวได้

เมื่อโหลดแล้ว ส่วนขยายสามารถแทนที่รายการเสียงที่ประกาศได้ด้วยการเรียก chrome.ttsEngine.updateVoices (โปรดทราบว่าพารามิเตอร์ที่ใช้ในการเรียกแบบเป็นโปรแกรมไปยัง updateVoicesอยู่ในกล่องอูฐ เช่น voiceName ซึ่งแตกต่างจากไฟล์ Manifest ที่ใช้ voice_name)

ประเภทเหตุการณ์ที่คุณอาจส่งได้จะสอดคล้องกับประเภทเหตุการณ์ที่เมธอด speak() ได้รับ:

• 'start': เครื่องยนต์เริ่มพูดคำพูดแล้ว
• 'word': ถึงขีดจำกัดของคำแล้ว ใช้ event.charIndex เพื่อกำหนดเสียงพูดปัจจุบัน ตำแหน่ง
• 'sentence': ถึงขีดจำกัดของประโยคแล้ว ใช้ event.charIndex เพื่อระบุเหตุการณ์ปัจจุบัน ในการพูด
• 'marker': ถึงเครื่องหมาย SSML ใช้ event.charIndex เพื่อกำหนดเสียงพูดปัจจุบัน ตำแหน่ง
• 'end': เครื่องพูดจบแล้ว
• 'error': เกิดข้อผิดพลาดเฉพาะเครื่องมือทำให้ไม่สามารถพูดคำพูดนี้ ส่งบอลมากขึ้น ข้อมูลใน event.errorMessage

เครื่องมืออ่านออกเสียงไม่ได้ส่งเหตุการณ์ 'interrupted' และ 'cancelled' สร้างขึ้นได้ โดยอัตโนมัติจาก Chrome

ไคลเอ็นต์การอ่านออกเสียงข้อความจะรับข้อมูลเสียงจากไฟล์ Manifest ของส่วนขยายได้โดยการเรียกใช้ tts.getVoices สมมติว่าคุณลงทะเบียน Listener กิจกรรมคำพูดตามที่อธิบายด้านล่าง

จัดการเหตุการณ์การพูด

เพื่อสร้างเสียงพูดตามคำขอของลูกค้า ส่วนขยายของคุณต้องลงทะเบียน Listener สำหรับทั้ง onSpeak และ onStop ดังนี้

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);

การตัดสินใจว่าจะส่งคำขอคำพูดใดๆ ไปยังส่วนขยายหรือไม่นั้นขึ้นอยู่กับ ส่วนขยายสนับสนุนพารามิเตอร์เสียงที่ระบุในไฟล์ Manifest และได้ลงทะเบียน Listener ของ onSpeak และ onStop กล่าวอีกนัยหนึ่งคือ ไม่มีวิธีที่ส่วนขยายจะได้รับ และตัดสินใจแบบไดนามิกว่าจะจัดการหรือไม่

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,
)