AudioNode: phương thức disconnect()

Cú pháp

disconnect()
disconnect(output)
disconnect(destination)
disconnect(destination, output)
disconnect(destination, output, input)

Tham số

Có nhiều phiên bản của phương thức disconnect(), chấp nhận các tổ hợp tham số khác nhau để kiểm soát những nút nào sẽ bị ngắt kết nối. Nếu không có tham số nào được cung cấp, mọi kết nối đầu ra sẽ bị ngắt.

destination Optional

Một AudioNode hoặc AudioParam chỉ định nút hoặc các nút sẽ bị ngắt kết nối. Nếu giá trị này là một AudioNode, một nút duy nhất sẽ bị ngắt kết nối, với các tham số tùy chọn khác (output và/hoặc input) tiếp tục giới hạn đầu vào và/hoặc đầu ra nào cần ngắt. Nếu giá trị này là một AudioParam, thì kết nối tới AudioParam đó sẽ bị chấm dứt, và đóng góp của nút vào tham số tính toán đó sẽ trở thành 0 kể từ khi thay đổi có hiệu lực.

output Optional

Chỉ mục mô tả đầu ra nào từ AudioNode hiện tại sẽ bị ngắt kết nối. Các số chỉ mục được xác định theo số lượng kênh đầu ra (xem Kênh âm thanh).

input Optional

Chỉ mục mô tả đầu vào nào của AudioNode đích được chỉ định sẽ bị ngắt kết nối. Các số chỉ mục được xác định theo số lượng kênh đầu vào (xem Kênh âm thanh). Không áp dụng nếu destination là một AudioParam.

Giá trị trả về

Không có (undefined).

Ngoại lệ

IndexSizeError DOMException

Được ném ra nếu giá trị chỉ định cho input hoặc output là không hợp lệ, tham chiếu tới một nút không tồn tại hoặc nằm ngoài phạm vi cho phép.

InvalidAccessError DOMException

Được ném ra nếu nút mà disconnect() được gọi trên đó không được kết nối tới nút destination được chỉ định.

Ví dụ

const audioCtx = new AudioContext();

const oscillator = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

gainNode.disconnect();

Thông số kỹ thuật

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

Xem thêm

• Sử dụng Web Audio API