SpeechRecognition: Phương thức tĩnh available()

Cú pháp

available(options)

Tham số

options

Một đối tượng chỉ định các tùy chọn cho việc kiểm tra khả dụng. Các thuộc tính có thể bao gồm:

langs

Một mảng chứa một hoặc nhiều chuỗi có thẻ ngôn ngữ BCP 47, mỗi chuỗi đại diện cho một ngôn ngữ cần kiểm tra khả dụng. Truyền một mảng langs rỗng sẽ không gây ra lỗi, nhưng giá trị trả về sẽ luôn phân giải thành unavailable.

processLocally Optional

Một boolean chỉ định việc kiểm tra khả dụng của các ngôn ngữ chỉ cho nhận dạng giọng nói trên thiết bị (true) hay cho nhận dạng giọng nói trên thiết bị hoặc từ xa (false). Giá trị mặc định là false.

Note: Không thể sử dụng available() để đảm bảo rằng một dịch vụ từ xa hỗ trợ các ngôn ngữ được chỉ định. Giá trị false có nghĩa là một trong hai dịch vụ nhận dạng giọng nói trên thiết bị hoặc từ xa hỗ trợ chúng.

Giá trị trả về

Một Promise phân giải với một giá trị được liệt kê cho biết khả dụng của các ngôn ngữ được chỉ định cho nhận dạng giọng nói.

Các giá trị có thể bao gồm:

available

Cho biết rằng hỗ trợ cho tất cả các ngôn ngữ được chỉ định đều khả dụng.

• Nếu processLocally được thiết lập thành true, available có nghĩa là nhận dạng giọng nói khả dụng cho các ngôn ngữ đó trên thiết bị (các gói ngôn ngữ cần thiết đã được tải xuống và cài đặt trên máy tính của người dùng).
• Nếu processLocally được thiết lập thành false, available có nghĩa là nhận dạng giọng nói khả dụng cho các ngôn ngữ đó trên thiết bị hoặc từ xa.

downloading

Cho biết rằng hỗ trợ cho các ngôn ngữ được chỉ định khả dụng trên thiết bị, và gói ngôn ngữ liên quan cho ít nhất một ngôn ngữ đang trong quá trình tải xuống. Chỉ liên quan khi processLocally là true.

downloadable

Cho biết rằng hỗ trợ cho các ngôn ngữ được chỉ định khả dụng trên thiết bị, nhưng gói ngôn ngữ liên quan cho ít nhất một ngôn ngữ chưa được tải xuống. Chỉ liên quan khi processLocally là true.

unavailable

Cho biết rằng hỗ trợ cho ít nhất một trong các ngôn ngữ được chỉ định không khả dụng.

• Nếu processLocally được thiết lập thành true, unavailable có nghĩa là nhận dạng giọng nói trên thiết bị không khả dụng cho ít nhất một trong các ngôn ngữ được chỉ định.
• Nếu processLocally được thiết lập thành false, unavailable có nghĩa là nhận dạng giọng nói không khả dụng cho ít nhất một trong các ngôn ngữ được chỉ định trên thiết bị hoặc từ xa.

Giá trị trả về cuối cùng cho nhiều ngôn ngữ với các trạng thái khác nhau

Chỉ một giá trị trạng thái được trả về, ngay cả khi nhiều ngôn ngữ được chỉ định trong mảng langs. Nếu các ngôn ngữ được chỉ định khác nhau có các trạng thái khả dụng khác nhau, giá trị trả về cuối cùng là trạng thái "xa nhất" so với available cho bất kỳ ngôn ngữ nào, theo thứ tự được hiển thị trong các danh sách sau:

Nếu processLocally là false:

• Nếu tất cả ngôn ngữ là available, thì trả về available.
• Ngược lại, trả về unavailable.

Nếu processLocally là true:

• Nếu tất cả ngôn ngữ là available, trả về available.
• Nếu ít nhất một ngôn ngữ là downloading, trả về downloading.
• Nếu ít nhất một ngôn ngữ là downloadable, trả về downloadable.
• Nếu ít nhất một ngôn ngữ là unavailable, trả về unavailable.

Ngoại lệ

InvalidStateError DOMException

Tài liệu hiện tại không ở trạng thái hoạt động đầy đủ.

SyntaxError DOMException

Một hoặc nhiều chuỗi được chỉ định trong langs không phải là thẻ ngôn ngữ BCP 47 hợp lệ.

Ví dụ

Kiểm tra khả dụng trên thiết bị và cài đặt các gói ngôn ngữ

Để nhận dạng giọng nói trên thiết bị hoạt động, trình duyệt phải có một gói ngôn ngữ được cài đặt cho ngôn ngữ bạn muốn nhận dạng. Nếu bạn chạy phương thức start() sau khi chỉ định processLocally = true nhưng gói ngôn ngữ chính xác chưa được cài đặt, lời gọi hàm sẽ thất bại với lỗi language-not-supported.

Để cài đặt gói ngôn ngữ chính xác, đảm bảo bạn làm theo hai bước sau:

1. Kiểm tra xem gói ngôn ngữ có khả dụng trên máy tính của người dùng hay không bằng phương thức available().
2. Cài đặt gói ngôn ngữ nếu nó không khả dụng bằng phương thức SpeechRecognition.install().

Các bước này được xử lý bằng đoạn mã sau:

startBtn.addEventListener("click", () => {
  // check availability of target language
  SpeechRecognition.available({ langs: ["en-US"], processLocally: true }).then(
    (result) => {
      if (result === "unavailable") {
        diagnostic.textContent = `en-US not available to download at this time. Sorry!`;
      } else if (result === "available") {
        recognition.start();
        console.log("Ready to receive a color command.");
      } else {
        diagnostic.textContent = `en-US language pack downloading`;
        SpeechRecognition.install({
          langs: ["en-US"],
          processLocally: true,
        }).then((result) => {
          if (result) {
            diagnostic.textContent = `en-US language pack downloaded. Try again.`;
          } else {
            diagnostic.textContent = `en-US language pack failed to download. Try again later.`;
          }
        });
      }
    },
  );
});

Đầu tiên chúng ta chạy phương thức available(), chỉ định một ngôn ngữ (langs: ["en-US"]) để kiểm tra khả dụng, và processLocally: true. Chúng ta kiểm tra ba khả năng khác nhau của giá trị trả về:

• Nếu giá trị kết quả là unavailable, có nghĩa là không có gói ngôn ngữ phù hợp nào để tải xuống. Chúng ta cũng in một thông báo thích hợp ra đầu ra.
• Nếu giá trị kết quả là available, có nghĩa là gói ngôn ngữ khả dụng cục bộ, nên việc nhận dạng có thể bắt đầu. Trong trường hợp này, chúng ta chạy start() và ghi một thông báo vào console khi ứng dụng sẵn sàng nhận giọng nói.
• Nếu giá trị là một giá trị khác (downloadable hoặc downloading), chúng ta in một thông báo chẩn đoán để thông báo cho người dùng rằng việc tải xuống gói ngôn ngữ đang bắt đầu, sau đó chạy phương thức install() để xử lý việc tải xuống.

Phương thức install() hoạt động tương tự như phương thức available(), ngoại trừ đối tượng tùy chọn của nó chỉ nhận mảng langs. Khi chạy, nó bắt đầu tải xuống gói ngôn ngữ en-US và trả về một Promise phân giải với một boolean cho biết các gói ngôn ngữ được chỉ định đã được tải xuống và cài đặt thành công (true) hay không (false).

Đoạn mã này được trích từ ví dụ on-device speech color changer (chạy demo trực tiếp). Xem Sử dụng Web Speech API để biết giải thích đầy đủ.

Đặc tả kỹ thuật

Tương thích trình duyệt

Xem thêm

• Web Speech API
• Sử dụng Web Speech API
• SpeechRecognition.processLocally
• SpeechRecognition.install()