chrome.ttsEngine

Mô tả

Quyền

Khái niệm và cách sử dụng

Tiện ích có thể tự đăng ký làm công cụ chuyển lời nói. Khi làm như vậy, ứng dụng có thể chặn một số hoặc tất cả các lệnh gọi vào các hàm như tts.speak() và tts.stop(), đồng thời cung cấp phương thức triển khai thay thế. Các tiện ích được miễn phí sử dụng mọi công nghệ web hiện có để cung cấp lời nói, bao gồm cả âm thanh truyền trực tuyến từ máy chủ, âm thanh HTML5. Tiện ích thậm chí có thể làm điều gì đó khác qua lời nói, chẳng hạn như hiển thị phụ đề trong cửa sổ bật lên hoặc gửi chúng dưới dạng thông điệp nhật ký một máy chủ từ xa.

Để triển khai công cụ TTS, tiện ích phải khai báo "ttsEngine" rồi khai báo tất cả những giọng nói mà công cụ này cung cấp trong tệp kê khai của tiện ích, chẳng hạn như sau:

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

Mỗi tiện ích có thể chỉ định số lượng giọng nói bất kỳ.

Tham số voice_name là bắt buộc. Tên này phải đủ mô tả để xác định tên của giọng nói và công cụ được sử dụng. Trong trường hợp hiếm gặp là 2 tiện ích đăng ký giọng nói có cùng tên, ứng dụng khách có thể chỉ định mã nhận dạng tiện ích sẽ thực hiện quá trình tổng hợp.

Bạn không bắt buộc phải sử dụng tham số lang, nhưng bạn nên dùng tham số này. Hầu như mọi lúc, giọng nói đều có thể tổng hợp bằng một ngôn ngữ duy nhất. Khi một công cụ hỗ trợ nhiều ngôn ngữ, công cụ đó có thể dễ dàng hãy đăng ký một giọng nói riêng cho mỗi ngôn ngữ. Trong một số ít trường hợp mà một giọng nói có thể xử lý nhiều ngôn ngữ, cách dễ nhất là chỉ cần liệt kê hai giọng nói riêng biệt và xử lý các giọng nói đó bằng cùng một logic trong nội bộ. Tuy nhiên, nếu bạn muốn tạo một giọng nói có thể xử lý cách phát âm ở bất kỳ ngôn ngữ, hãy bỏ tham số lang khỏi tệp kê khai của tiện ích.

Cuối cùng, bạn cần phải có thông số event_types nếu công cụ có thể gửi các sự kiện để cập nhật ứng dụng tiến trình tổng hợp tiếng nói. Ở mức tối thiểu, việc hỗ trợ loại sự kiện 'end' để cho biết khi lời nói kết thúc được khuyến nghị, nếu không Chrome không thể lên lịch các cách phát âm trong hàng đợi.

Sau khi tải, tiện ích có thể thay thế danh sách các giọng nói đã khai báo bằng cách gọi chrome.ttsEngine.updateVoices. (Lưu ý rằng các tham số được sử dụng trong lệnh gọi có lập trình đến updateVoices theo kiểu viết lạc đà: ví dụ: voiceName, không giống như tệp kê khai sử dụng voice_name.)

Các loại sự kiện mà bạn có thể gửi tương ứng với các loại sự kiện mà phương thức speak() nhận được:

• 'start': Công cụ đã bắt đầu đọc cách phát âm.
• 'word': Đã đạt đến giới hạn từ. Sử dụng event.charIndex để xác định lời nói hiện tại vị trí.
• 'sentence': Đã đạt đến giới hạn của câu. Sử dụng event.charIndex để xác định thời điểm hiện tại vị trí lời nói.
• 'marker': Đã đạt đến một điểm đánh dấu SSML. Sử dụng event.charIndex để xác định lời nói hiện tại vị trí.
• 'end': Công cụ đã đọc xong cách phát âm.
• 'error': Đã xảy ra lỗi cụ thể đối với công cụ và không thể đọc lời nói này. Chuyển thêm trong event.errorMessage.

Công cụ chuyển lời nói không gửi các sự kiện 'interrupted' và 'cancelled'; chúng được tạo tự động bằng Chrome.

Ứng dụng chuyển văn bản sang lời nói có thể nhận thông tin thoại từ tệp kê khai của tiện ích bằng cách gọi tts.getVoices, giả sử bạn đã đăng ký trình nghe sự kiện lời nói như mô tả dưới đây.

Xử lý sự kiện lời nói

Để tạo giọng nói theo yêu cầu của ứng dụng, tiện ích của bạn phải đăng ký người nghe cho cả hai onSpeak và onStop, chẳng hạn như:

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

Quyết định có gửi một yêu cầu giọng nói nhất định tới tiện ích hay không sẽ chỉ dựa trên liệu tiện ích có hỗ trợ các tham số giọng nói nhất định trong tệp kê khai hay không và đã đăng ký cho onSpeak và onStop. Nói cách khác, không có cách nào để tiện ích nhận được yêu cầu lời nói và tự động quyết định xem có xử lý yêu cầu đó hay không.

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