RTCDTMFSender: insertDTMF() method

Cú pháp

insertDTMF(tones)
insertDTMF(tones, duration)
insertDTMF(tones, duration, interToneGap)

Tham số

tones

Một chuỗi chứa các mã DTMF được truyền đến người nhận. Chỉ định một chuỗi rỗng là tham số tones sẽ xóa buffer âm thanh, hủy bỏ bất kỳ âm thanh nào đang trong hàng đợi. Ký tự dấu phẩy , trong chuỗi chèn một khoảng dừng 2 giây. Ví dụ "12,34" sẽ gửi âm thanh cho 1 và 2, tạm dừng hai giây, rồi gửi 3 và 4. Nhiều dấu phẩy thêm khoảng dừng dài hơn, vì vậy ,, sẽ thêm bốn giây.

duration Optional

Lượng thời gian, tính bằng mili giây, mỗi âm thanh DTMF nên kéo dài. Giá trị này phải từ 40 ms đến 6000 ms (6 giây), bao gồm. Mặc định là 100 ms.

interToneGap Optional

Khoảng thời gian, tính bằng mili giây, chờ giữa các âm thanh. Trình duyệt sẽ thực thi giá trị tối thiểu là 30 ms (tức là nếu bạn chỉ định giá trị thấp hơn, 30 ms sẽ được sử dụng thay thế). Mặc định là 70 ms.

Giá trị trả về

Không có (undefined).

Ngoại lệ

InvalidStateError DOMException

Được ném ra nếu không thể gửi âm thanh DTMF vì track đã bị dừng hoặc ở trạng thái chỉ đọc hoặc không hoạt động.

InvalidCharacterError DOMException

Được ném ra nếu một hoặc nhiều ký tự trong tones không phải là ký tự DTMF hợp lệ (0-9, A-Z, #, hoặc ,).

Ví dụ

Sử dụng insertDTMF để gửi âm thanh DTMF

Ví dụ này cho thấy cách sử dụng phương thức insertDTMF() để gửi âm thanh qua kết nối WebRTC.

Mã đầu tiên kiểm tra xem thuộc tính canInsertDTMF có được định nghĩa hay không, và nếu có, sử dụng nó để kiểm tra xem việc chèn âm thanh DTMF có được hỗ trợ không. Nếu tính năng được hỗ trợ, insertDTMF() được gọi để chèn một âm thanh.

if (sender.dtmf.canInsertDTMF) {
  const duration = 500;
  sender.dtmf.insertDTMF("1234", duration);
} else {
  console.log("DTMF function not available");
}

Thông số kỹ thuật

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

Xem thêm

• WebRTC API
• Using DTMF with WebRTC
• RTCPeerConnection
• RTCDTMFSender
• RTCRtpSender