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 และได้ลงทะเบียนการฟังสำหรับ 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,
)