Hướng dẫn python-sounddevice documentation - tài liệu python-sounddevice

Python-Sundevice

Chơi và ghi âm với Python

Tổng quan API:
  • Các chức năng thuận tiện để chơi và ghi lại các mảng numpy:
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    4,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    6 và các chức năng liên quan
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    9,
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    0
  • Cài đặt mặc định rộng mô-đun:
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    1
  • Các luồng Portaudio, sử dụng các mảng Numpy:
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    2,
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    3,
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    4
  • Các luồng Portaudio, sử dụng các đối tượng bộ đệm Python (không cần thiết):
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5,
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    6,
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    7
  • Các chức năng để có được thông tin về phần cứng có sẵn:
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8,
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    9,
    >>> sd.default.channels = 1, 2
    
    0,
    >>> sd.default.channels = 1, 2
    
    1
  • Các chức năng và lớp học linh tinh:
    >>> sd.default.channels = 1, 2
    
    2,
    >>> sd.default.channels = 1, 2
    
    3,
    >>> sd.default.channels = 1, 2
    
    4,
    >>> sd.default.channels = 1, 2
    
    5,
    >>> sd.default.channels = 1, 2
    
    6
  • Cài đặt dành riêng cho nền tảng:
    >>> sd.default.channels = 1, 2
    
    7,
    >>> sd.default.channels = 1, 2
    
    8,
    >>> sd.default.channels = 1, 2
    
    9
Tài liệu trực tuyến: http: //python-sounddevice.readthedocs.io/ ________ 50 ________ 51 (data, sampleRate = none, ánh xạ = không, chặn = false, loop = false,(data, samplerate=None, mapping=None, blocking=False, loop=False, **kwargs)[source]

Phát lại một mảng numpy chứa dữ liệu âm thanh.

Parameters:
  • Dữ liệu (Array_like) - Dữ liệu âm thanh sẽ được phát lại. Các cột của một mảng hai chiều được hiểu là các kênh, các mảng một chiều được coi là dữ liệu đơn sắc. Các loại dữ liệu float64, float32, int32, int16, int8 và uint8 có thể được sử dụng. Dữ liệu float64 chỉ đơn giản được chuyển đổi thành float32 trước khi chuyển nó cho portaudio, bởi vì nó không được hỗ trợ tự nhiên. (array_like) – Audio data to be played back. The columns of a two-dimensional array are interpreted as channels, one-dimensional arrays are treated as mono data. The data types float64, float32, int32, int16, int8 and uint8 can be used. float64 data is simply converted to float32 before passing it to PortAudio, because it’s not supported natively.
  • Ánh xạ (Array_like, Tùy chọn) - Danh sách số kênh (bắt đầu với 1) trong đó các cột dữ liệu sẽ được phát lại. Phải có cùng độ dài với số lượng kênh trong dữ liệu (trừ khi dữ liệu là mono, trong trường hợp đó tín hiệu được phát lại trên tất cả các kênh đầu ra đã cho). Mỗi số kênh chỉ có thể xuất hiện một lần trong ánh xạ. (array_like, optional) – List of channel numbers (starting with 1) where the columns of data shall be played back on. Must have the same length as number of channels in data (except if data is mono, in which case the signal is played back on all given output channels). Each channel number may only appear once in mapping.
  • chặn (bool, tùy chọn) - nếu
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 (mặc định), trả về ngay lập tức (nhưng phát lại vẫn tiếp tục trong nền), nếu
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, hãy đợi cho đến khi phát lại kết thúc. Một lời mời không chặn có thể được dừng lại với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 hoặc biến thành một chặn chặn với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7.
    (bool, optional) – If
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 (the default), return immediately (but playback continues in the background), if
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, wait until playback is finished. A non-blocking invocation can be stopped with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 or turned into a blocking one with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7.
  • Loop (Bool, Tùy chọn) - Phát dữ liệu trong một vòng lặp. (bool, optional) – Play data in a loop.
Các tham số khác:
& nbsp;

Lấy mẫu, ** kwargs - tất cả các tham số của

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4 - ngoại trừ các kênh, DTYPE, Callback và Forest_Callback - có thể được sử dụng. – All parameters of
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4 – except channels, dtype, callback and finished_callback – can be used.

________ 50 ________ 58 (khung = none, sampleRate = none, kênh = không(frames=None, samplerate=None, channels=None, dtype=None, out=None, mapping=None, blocking=False, **kwargs)[source]

Ghi lại dữ liệu âm thanh vào một mảng numpy.

Parameters:
  • khung (int, đôi khi tùy chọn) - số lượng khung để ghi. Không cần thiết nếu ra ngoài được đưa ra. (int, sometimes optional) – Number of frames to record. Not needed if out is given.
  • Kênh (int, tùy chọn) - Số lượng kênh để ghi. Không cần thiết nếu ánh xạ hoặc ra ngoài được đưa ra. Giá trị mặc định có thể được thay đổi với
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.
    (int, optional) – Number of channels to record. Not needed if mapping or out is given. The default value can be changed with
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.
  • DTYPE (str hoặc numpy.dtype, tùy chọn) - loại dữ liệu của bản ghi. Không cần thiết nếu ra ngoài được đưa ra. Các loại dữ liệu Float64, Float32, Int32, Int16, Int8 và Uint8 có thể được sử dụng. Đối với
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    0, dữ liệu âm thanh được ghi lại ở định dạng float32 và được chuyển đổi sau đó, bởi vì nó không được hỗ trợ bởi Portaudio. Giá trị mặc định có thể được thay đổi với
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.
    (str or numpy.dtype, optional) – Data type of the recording. Not needed if out is given. The data types float64, float32, int32, int16, int8 and uint8 can be used. For
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    0, audio data is recorded in float32 format and converted afterwards, because it’s not natively supported by PortAudio. The default value can be changed with
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.
  • Ánh xạ (Array_like, Tùy chọn) - Danh sách số kênh (bắt đầu bằng 1) để ghi. Nếu ánh xạ được đưa ra, các kênh bị bỏ qua âm thầm. (array_like, optional) – List of channel numbers (starting with 1) to record. If mapping is given, channels is silently ignored.
  • chặn (bool, tùy chọn) - nếu
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 (mặc định), trả về ngay lập tức (nhưng ghi tiếp tục ở chế độ nền), nếu
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, hãy đợi cho đến khi ghi kết thúc. Một lời mời không chặn có thể được dừng lại với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 hoặc biến thành một chặn chặn với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7.
    (bool, optional) – If
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 (the default), return immediately (but recording continues in the background), if
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, wait until recording is finished. A non-blocking invocation can be stopped with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 or turned into a blocking one with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7.
Returns:

numpy.ndarray hoặc loại (ra) - dữ liệu được ghi lại.

Ghi chú

Theo mặc định (

>>> sd.default.samplerate = None
>>> sd.default.device = None, 4
6), một mảng dữ liệu được trả về vẫn đang được ghi vào khi ghi! Dữ liệu được trả về chỉ hợp lệ khi ghi lại đã dừng. Sử dụng
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
7 để đảm bảo ghi âm kết thúc.

Các tham số khác:
& nbsp;
  • Lấy mẫu, ** kwargs - tất cả các tham số của
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    4 - ngoại trừ các kênh, DTYPE, Callback và Forest_Callback - có thể được sử dụng.
    (numpy.ndarray or subclass, optional) – If out is specified, the recorded data is written into the given array instead of creating a new array. In this case, the arguments frames, channels and dtype are silently ignored! If mapping is given, its length must match the number of channels in out.
  • ________ 50 ________ 58 (khung = none, sampleRate = none, kênh = không – All parameters of
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    3 – except callback and finished_callback – can be used.
Ghi lại dữ liệu âm thanh vào một mảng numpy.(data, samplerate=None, channels=None, dtype=None, out=None, input_mapping=None, output_mapping=None, blocking=False, **kwargs)[source]

khung (int, đôi khi tùy chọn) - số lượng khung để ghi. Không cần thiết nếu ra ngoài được đưa ra.

Parameters:
  • Kênh (int, tùy chọn) - Số lượng kênh để ghi. Không cần thiết nếu ánh xạ hoặc ra ngoài được đưa ra. Giá trị mặc định có thể được thay đổi với
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.
    (array_like) – Audio data to be played back. See
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    4.
  • DTYPE (str hoặc numpy.dtype, tùy chọn) - loại dữ liệu của bản ghi. Không cần thiết nếu ra ngoài được đưa ra. Các loại dữ liệu Float64, Float32, Int32, Int16, Int8 và Uint8 có thể được sử dụng. Đối với
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    0, dữ liệu âm thanh được ghi lại ở định dạng float32 và được chuyển đổi sau đó, bởi vì nó không được hỗ trợ bởi Portaudio. Giá trị mặc định có thể được thay đổi với
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.
    (int, sometimes optional) – Number of input channels, see
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5. The number of output channels is obtained from data.shape.
  • Ánh xạ (Array_like, Tùy chọn) - Danh sách số kênh (bắt đầu bằng 1) để ghi. Nếu ánh xạ được đưa ra, các kênh bị bỏ qua âm thầm. (str or numpy.dtype, optional) – Input data type, see
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5. If dtype is not specified, it is taken from data.dtype (i.e.
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1 is ignored). The output data type is obtained from data.dtype anyway.
  • input_mapping, output_mapping (Array_like, Tùy chọn) - Xem ánh xạ tham số của
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5 và
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    4, tương ứng.
    (array_like, optional) – See the parameter mapping of
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5 and
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    4, respectively.
  • chặn (bool, tùy chọn) - nếu
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 (mặc định), trả về ngay lập tức (nhưng tiếp tục phát lại/ghi trong nền), nếu
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, hãy đợi cho đến khi phát lại/ghi kết thúc. Một lời mời không chặn có thể được dừng lại với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 hoặc biến thành một chặn chặn với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7.
    (bool, optional) – If
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 (the default), return immediately (but continue playback/recording in the background), if
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, wait until playback/recording is finished. A non-blocking invocation can be stopped with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 or turned into a blocking one with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    7.
Returns:

numpy.ndarray hoặc loại (ra) - dữ liệu được ghi lại. Xem

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5.

Các tham số khác:
& nbsp;
  • ra (numpy.ndarray hoặc lớp con, tùy chọn) - xem
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5.
    (numpy.ndarray or subclass, optional) – See
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5.
  • Lấy mẫu, ** kwargs - tất cả các tham số của
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    2 - ngoại trừ các kênh, DTYPE, Callback và Forest_Callback - có thể được sử dụng.
    – All parameters of
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    2 – except channels, dtype, callback and finished_callback – can be used.
________ 50 ________ 85 (bỏ qua_errors = true) [Nguồn] ¶(ignore_errors=True)[source]

Đợi ____ 24/________ 25/________ 26 được hoàn thành.

Phát lại/ghi âm có thể được dừng lại với

outdata = my_data  # Don't do this!
9.

Returns:CallbackFlags hoặc không có-nếu ít nhất một bộ đệm quá mức/underrun đã xảy ra trong lần phát/ghi âm cuối cùng, một đối tượng
>>> sd.default.channels = 1, 2
4 được trả về.
________ 50 ________ 92 (bỏ qua_errors = true) [Nguồn] ¶(ignore_errors=True)[source]

Ngừng phát lại/ghi âm.

Điều này chỉ dừng

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6, nhưng không có ảnh hưởng đến các luồng được tạo bằng
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
3,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
5,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
6,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
7.

________ 50 ________ 103 () [Nguồn] ¶()[source]

Nhận thông tin về quá mức/dòng chảy trong ________ 24/________ 25/________ 26.

Returns:CallbackFlags - Một đối tượng
>>> sd.default.channels = 1, 2
4 chứa thông tin về việc gọi cuối cùng của
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5 hoặc
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6.
________ 50 ________ 112 () [Nguồn] ¶()[source]

Nhận một tham chiếu đến luồng hiện tại.

Điều này chỉ áp dụng cho các luồng được tạo bởi các cuộc gọi đến

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5 hoặc
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6.

Returns:Luồng - một
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
3 hoặc
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2 liên quan đến việc gọi cuối cùng của
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5 hoặc
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6, tương ứng.
________ 50 ________ 123 (thiết bị = none, kint = none) [nguồn] ¶(device=None, kind=None)[source]

Trả về thông tin về các thiết bị có sẵn.

Thông tin và khả năng của các thiết bị Portaudio. Các thiết bị có thể hỗ trợ đầu vào, đầu ra hoặc cả đầu vào và đầu ra.

Để tìm (các) thiết bị đầu vào/đầu ra mặc định, hãy sử dụng

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
24.

Parameters:
  • thiết bị (int hoặc str, tùy chọn) - ID thiết bị số hoặc (các) tên con thiết bị. Nếu được chỉ định, thông tin chỉ về thiết bị đã cho được trả về trong một từ điển. (int or str, optional) – Numeric device ID or device name substring(s). If specified, information about only the given device is returned in a single dictionary.
  • loại ({’đầu vào,’ đầu ra ({‘input’, ‘output’}, optional) – If device is not specified and kind is
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    25 or
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    26, a single dictionary is returned with information about the default input or output device, respectively.
Returns:

Dict hoặc Devicelist - Một từ điển có thông tin về thiết bị đã cho hoặc - nếu không có đối số nào được chỉ định -

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
27 chứa một từ điển cho mỗi thiết bị có sẵn. Các từ điển có các khóa sau:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
28

Tên của thiết bị.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
29

ID của API máy chủ tương ứng. Sử dụng

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
9 để lấy thông tin về API máy chủ.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
31,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
32

Số lượng kênh đầu vào/đầu ra tối đa được thiết bị hỗ trợ. Xem

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
9.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
34,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
35

Giá trị độ trễ mặc định cho hiệu suất tương tác. Điều này được sử dụng nếu

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
36 (hoặc đối số độ trễ của
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, v.v.) được đặt thành
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
39.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
40,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
41

Giá trị độ trễ mặc định cho các ứng dụng không tương tác mạnh mẽ (ví dụ: phát tệp âm thanh). Điều này được sử dụng nếu

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
36 (hoặc đối số độ trễ của
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, v.v.) được đặt thành
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
45.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
46

Tần số lấy mẫu mặc định của thiết bị. Điều này được sử dụng nếu

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
47 không được đặt.

Ghi chú

Danh sách các thiết bị cũng có thể được hiển thị trong một thiết bị đầu cuối:

Ví dụ

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
27 được trả lại có thể được lập chỉ mục và lặp lại như bất kỳ loại trình tự nào (mang lại từ điển đã đề cập ở trên), nhưng nó cũng có một biểu diễn chuỗi đặc biệt được hiển thị khi được sử dụng trong phiên Python tương tác.

Mỗi thiết bị có sẵn được liệt kê trên một dòng cùng với ID thiết bị tương ứng, có thể được gán cho

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
24 hoặc được sử dụng làm đối số thiết bị trong
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, v.v.

Ký tự đầu tiên của một dòng là

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
52 cho thiết bị đầu vào mặc định,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
53 cho thiết bị đầu ra mặc định và
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
54 cho thiết bị đầu vào/đầu ra mặc định. Sau ID thiết bị và tên thiết bị, tên API máy chủ tương ứng được hiển thị. Ở cuối mỗi dòng, số lượng kênh đầu vào và đầu ra tối đa được hiển thị.

Trên máy tính GNU/Linux, nó có thể trông giống như thế này:

>>> import sounddevice as sd
>>> sd.query_devices()
   0 HDA Intel: ALC662 rev1 Analog (hw:0,0), ALSA (2 in, 2 out)
   1 HDA Intel: ALC662 rev1 Digital (hw:0,1), ALSA (0 in, 2 out)
   2 HDA Intel: HDMI 0 (hw:0,3), ALSA (0 in, 8 out)
   3 sysdefault, ALSA (128 in, 128 out)
   4 front, ALSA (0 in, 2 out)
   5 surround40, ALSA (0 in, 2 out)
   6 surround51, ALSA (0 in, 2 out)
   7 surround71, ALSA (0 in, 2 out)
   8 iec958, ALSA (0 in, 2 out)
   9 spdif, ALSA (0 in, 2 out)
  10 hdmi, ALSA (0 in, 8 out)
* 11 default, ALSA (128 in, 128 out)
  12 dmix, ALSA (0 in, 2 out)
  13 /dev/dsp, OSS (16 in, 16 out)

Lưu ý rằng ALSA cung cấp quyền truy cập vào một số thiết bị thực tế của người Viking và một số thiết bị ảo. Cái sau đôi khi có số lượng đầu vào và đầu ra (ảo) cao một cách lố bịch.

Trên macOS, bạn có thể nhận được một cái gì đó tương tự như thế này:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)

________ 50 ________ 156 (index = none) [nguồn] ¶(index=None)[source]

Trả về thông tin về API máy chủ có sẵn.

Parameters:Index (int, tùy chọn) - Nếu được chỉ định, thông tin chỉ về chỉ mục API máy chủ đã cho được trả về trong một từ điển. (int, optional) – If specified, information about only the given host API index is returned in a single dictionary.
Returns:Dict hoặc Tuple of Dict - Một từ điển có thông tin về chỉ mục API máy chủ đã cho hoặc - nếu không có chỉ mục nào được chỉ định - một bộ chứa một từ điển cho mỗi API máy chủ có sẵn. Các từ điển có các khóa sau: ________ 128 Tên của API máy chủ API .________ 158A DANH SÁCH ID thiết bị thuộc API máy chủ. Sử dụng
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
8 để lấy thông tin về thiết bị .________ 160,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
61 ID thiết bị của thiết bị đầu vào/đầu ra mặc định của API máy chủ. Nếu không có thiết bị đầu vào/đầu ra mặc định tồn tại cho API máy chủ đã cho, thì đây là -1.

Ghi chú

(Các) thiết bị mặc định tổng thể - có thể được ghi đè bằng cách gán cho

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
24 - ưu tiên (các) lần so với
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
63 và thông tin trong các từ điển đã đề cập.

________ 50 ________ 165 (thiết bị = không, kênh = none, dtype = không(device=None, channels=None, dtype=None, extra_settings=None, samplerate=None)[source]

Kiểm tra nếu cài đặt thiết bị đầu vào được hỗ trợ.

Tất cả các tham số là tùy chọn, cài đặt

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
1 được sử dụng cho bất kỳ tham số không xác định nào. Nếu các cài đặt được hỗ trợ, chức năng không làm gì cả; Nếu không, một ngoại lệ được nâng lên.

Parameters:
  • Thiết bị (int hoặc str, tùy chọn) - ID thiết bị hoặc con tên thiết bị, xem
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    24.
    (int or str, optional) – Device ID or device name substring(s), see
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    24.
  • Các kênh (int, tùy chọn) - Số lượng kênh đầu vào, xem
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.
    (int, optional) – Number of input channels, see
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.
  • DTYPE (str hoặc numpy.dtype, tùy chọn) - Kiểu dữ liệu cho các mẫu đầu vào, xem
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.
    (str or numpy.dtype, optional) – Data type for input samples, see
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.
  • Extra_Sinstall (Cài đặt đối tượng, tùy chọn)-Điều này có thể được sử dụng cho các cài đặt đầu vào dành riêng cho máy chủ-API. Xem
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    70.
    (settings object, optional) – This can be used for host-API-specific input settings. See
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    70.
  • Lấy mẫu (phao, tùy chọn) - Tần số lấy mẫu, xem
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    47.
    (float, optional) – Sampling frequency, see
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    47.
________ 50 ________ 173 (thiết bị = không, kênh = none, dtype = không(device=None, channels=None, dtype=None, extra_settings=None, samplerate=None)[source]

Kiểm tra nếu cài đặt thiết bị đầu ra được hỗ trợ.

Giống như

>>> sd.default.channels = 1, 2
0, chỉ dành cho cài đặt thiết bị đầu ra.

________ 50 ________ 176 (MSEC) [Nguồn] ¶(msec)[source]

Đặt người gọi ngủ ít nhất MSEC mili giây.

Chức năng có thể ngủ lâu hơn được yêu cầu, vì vậy don don dựa vào điều này cho thời gian âm nhạc chính xác.

________ 50 ________ 178 () [Nguồn] ¶()[source]

Nhận thông tin phiên bản cho Thư viện Portaudio.

Trả về số phát hành và mô tả văn bản của bản dựng Portaudio hiện tại, ví dụ:

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')

Lớp ________ 50 ________ 180 [Nguồn] ¶[source]

Nhận/đặt mặc định cho mô -đun SoundDevice.

Các thuộc tính

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
81,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
82,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
83,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
84 và
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
85 Chấp nhận các giá trị đơn lẻ chỉ định thuộc tính đã cho cho cả đầu vào và đầu ra. Tuy nhiên, nếu thuộc tính khác nhau giữa đầu vào và đầu ra, các cặp giá trị có thể được sử dụng, trong đó giá trị thứ nhất chỉ định đầu vào và giá trị thứ hai chỉ định đầu ra. Tất cả các thuộc tính khác luôn là các giá trị đơn.

Ví dụ

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']

Các giá trị khác nhau cho đầu vào và đầu ra:

>>> sd.default.channels = 1, 2

Một giá trị duy nhất đặt cả đầu vào và đầu ra cùng một lúc:

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]

Một thuộc tính có thể được đặt thành mặc định của Factory Factory bằng cách gán

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
86:

>>> sd.default.samplerate = None
>>> sd.default.device = None, 4

Sử dụng

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
87 để đặt lại tất cả các thuộc tính:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
88 = (không có, không có) ¶

Chỉ mục hoặc chuỗi truy vấn của thiết bị đầu vào/đầu ra mặc định.

Nếu không được ghi đè, điều này được truy vấn từ Portaudio.

Nếu một chuỗi được đưa ra, thiết bị được chọn chứa tất cả các bộ phận được phân tách theo không gian theo đúng thứ tự. Mỗi chuỗi thiết bị chứa tên của API máy chủ tương ứng cuối cùng. Việc so sánh chuỗi là không nhạy cảm trường hợp.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
89 = (không có, không có) ¶

Số lượng kênh đầu vào/đầu ra.

Số lượng kênh tối đa cho một thiết bị nhất định có thể được tìm thấy với

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
8.

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
91 = ('float32', 'float32') ¶

Kiểu dữ liệu được sử dụng cho các mẫu đầu vào/đầu ra.

Các loại

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
92,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
93,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
94,
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
95 và
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
96 có thể được sử dụng cho tất cả các luồng và chức năng. Ngoài ra,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6 hỗ trợ
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
00 (để thuận tiện, dữ liệu chỉ được chuyển đổi từ/sang
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
92) và
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
6,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
7 và
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
5 hỗ trợ
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
05 (được đóng gói 24 bit, không được hỗ trợ trong Numpy!)

Nếu Numpy có sẵn, các đối tượng

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
06 tương ứng cũng có thể được sử dụng.

Các biểu diễn điểm nổi

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
92 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
00 sử dụng +1.0 và -1.0 như các giá trị tối đa và tối thiểu, tương ứng.
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
96 là một định dạng 8 bit không dấu trong đó 128 được coi là mặt đất.

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
10 = ('cao', 'cao') ¶

Đề xuất độ trễ đầu vào/đầu ra tính bằng giây.

Các giá trị đặc biệt

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
39 và
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
45 có thể được sử dụng để chọn độ trễ thấp/cao mặc định của thiết bị đã chọn.
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
45 thường mạnh mẽ hơn (nghĩa là bộ đệm dưới/tràn ít có khả năng), nhưng độ trễ có thể quá lớn đối với các ứng dụng tương tác.

Cài đặt đầu vào/đầu ra cụ thể của máy chủ.

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
14 = không có

Tần số lấy mẫu trong Hertz (= khung mỗi giây).

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
15 = 0¶

Xem đối số khối của

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2.

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
17 = Sai¶

Vô hiệu hóa cắt.

Được đặt thành

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 để vô hiệu hóa việc cắt bỏ các mẫu ngoài phạm vi.

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
19 = Sai¶

Vô hiệu hóa hoà sắc.

Đặt thành

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 thành vô hiệu hóa màu sắc mặc định.

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
21 = Sai¶

Đặt hành vi cho tràn đầu vào của các luồng song công đầy đủ.

Được đặt thành

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 để yêu cầu rằng khi có thể một luồng song công đầy đủ sẽ không loại bỏ các mẫu đầu vào đã tràn mà không gọi gọi lại luồng. Cờ này chỉ có giá trị đối với các luồng gọi lại toàn diện (nghĩa là chỉ
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2 và
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
5 và chỉ khi gọi lại được chỉ định; điều này bao gồm
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6) và chỉ khi được sử dụng kết hợp với
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
26 (mặc định). Sử dụng cờ này không chính xác dẫn đến một lỗi đang được nâng lên. Xem thêm http://www.portaudio.com/docs/proposals/001-underflowoverflowhandling.html.

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
27 = Sai¶

Làm thế nào để lấp đầy bộ đệm đầu ra ban đầu.

Được đặt thành

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 để gọi gọi lại luồng để điền vào bộ đệm đầu ra ban đầu, thay vì hành vi mặc định của việc mồi các bộ đệm với số không (im lặng). Cờ này không có tác dụng cho chỉ đầu vào (
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
3 và
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
6) và chặn các luồng đọc/ghi (nghĩa là nếu gọi lại được chỉ định). Xem thêm http://www.portaudio.com/docs/proposals/020-allowcallbacktoprimestream.html.

________ 231¶

Chỉ mục của API máy chủ mặc định (chỉ đọc).

________ 232 () [Nguồn] ¶()[source]

Đặt lại tất cả các thuộc tính cho nhà sản xuất của họ mặc định.

Lớp ________ 50 ________ 234 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶(samplerate=None, blocksize=None, device=None, channels=None, dtype=None, latency=None, extra_settings=None, callback=None, finished_callback=None, clip_off=None, dither_off=None, never_drop_input=None, prime_output_buffers_using_stream_callback=None)[source]

Mở một luồng cho đầu vào và đầu ra đồng thời.

Để mở một luồng chỉ đầu vào hoặc chỉ sử dụng luồng chỉ đầu ra

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
3 hoặc
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4, tương ứng. Nếu bạn muốn xử lý dữ liệu âm thanh dưới dạng các đối tượng bộ đệm đơn giản thay vì các mảng numpy, hãy sử dụng
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
5,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
6 hoặc
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
7.

Một luồng duy nhất có thể cung cấp nhiều kênh đầu vào âm thanh phát trực tuyến thời gian thực và đầu ra cho ứng dụng máy khách. Một luồng cung cấp quyền truy cập vào phần cứng âm thanh được đại diện bởi một hoặc nhiều thiết bị. Tùy thuộc vào API máy chủ cơ bản, có thể mở nhiều luồng bằng cùng một thiết bị, tuy nhiên hành vi này được thực hiện được xác định. Các ứng dụng di động nên cho rằng một thiết bị có thể được sử dụng đồng thời nhiều nhất một luồng.

Thiết bị đối số, kênh, DTYPE và độ trễ có thể là các giá trị đơn (sẽ được sử dụng cho cả tham số đầu vào và đầu ra) hoặc các cặp giá trị (trong đó giá trị đầu tiên là giá trị cho đầu vào và mã thứ hai cho đầu ra).

Tất cả các đối số là tùy chọn, các giá trị cho các tham số không xác định được lấy từ đối tượng

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
1. Nếu một trong các giá trị của cặp tham số là
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
86, giá trị tương ứng từ
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
1 sẽ được sử dụng thay thế.

Luồng được tạo không hoạt động (xem

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
43,
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
44). Nó có thể được bắt đầu với
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
45.

Mỗi đối tượng luồng cũng là một trình quản lý ngữ cảnh, tức là nó có thể được sử dụng trong một câu lệnh để tự động gọi

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
45 khi bắt đầu câu lệnh và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
8 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
48 khi thoát.context manager, i.e. it can be used in a with statement to automatically call
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
45 in the beginning of the statement and
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
8 and
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
48 on exit.

Parameters:
  • Lấy mẫu (float, tùy chọn) - tần số lấy mẫu mong muốn (cho cả đầu vào và đầu ra). Giá trị mặc định có thể được thay đổi với

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    47. (float, optional) – The desired sampling frequency (for both input and output). The default value can be changed with
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    47.

  • BlockSize (int, tùy chọn) - Số lượng khung được truyền đến hàm gọi lại luồng hoặc độ chi tiết khối ưa thích cho luồng đọc/ghi chặn. Giá trị đặc biệt

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    26 (mặc định) có thể được sử dụng để yêu cầu gọi lại luồng sẽ nhận được số lượng khung tối ưu (và có thể thay đổi) dựa trên các yêu cầu của máy chủ và cài đặt độ trễ được yêu cầu. Giá trị mặc định có thể được thay đổi với
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    51.
    (int, optional) – The number of frames passed to the stream callback function, or the preferred block granularity for a blocking read/write stream. The special value
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    26 (which is the default) may be used to request that the stream callback will receive an optimal (and possibly varying) number of frames based on host requirements and the requested latency settings. The default value can be changed with
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    51.

    Ghi chú

    Với một số API máy chủ, việc sử dụng khối khác không cho luồng gọi lại có thể giới thiệu một lớp đệm bổ sung có thể giới thiệu độ trễ bổ sung. Portaudio đảm bảo rằng độ trễ bổ sung sẽ được giữ ở mức tối thiểu lý thuyết, tuy nhiên, người ta khuyến nghị nên sử dụng giá trị khối khác không chỉ khi thuật toán của bạn yêu cầu một số khung cố định trên mỗi lần gọi lại.

  • thiết bị (int hoặc str hoặc cặp của chúng, tùy chọn) - Chỉ mục thiết bị hoặc (các) chuỗi truy vấn chỉ định (các) thiết bị sẽ được sử dụng. (Các) giá trị mặc định có thể được thay đổi với

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    24. (int or str or pair thereof, optional) – Device index(es) or query string(s) specifying the device(s) to be used. The default value(s) can be changed with
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    24.

  • Các kênh (int hoặc cặp int, tùy chọn) - Số lượng kênh âm thanh được gửi đến gọi lại luồng hoặc được truy cập bởi

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 hoặc
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54. Nó có thể nằm trong khoảng từ 1 đến giá trị của
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    31 hoặc
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    32 trong Dict được trả về bởi
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8. Theo mặc định, số lượng kênh tối đa có thể cho thiết bị đã chọn được sử dụng (có thể không phải là thứ bạn muốn; xem
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8). (Các) giá trị mặc định có thể được thay đổi với
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.
    (int or pair of int, optional) – The number of channels of sound to be delivered to the stream callback or accessed by
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 or
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54. It can range from 1 to the value of
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    31 or
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    32 in the dict returned by
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8. By default, the maximum possible number of channels for the selected device is used (which may not be what you want; see
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8). The default value(s) can be changed with
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    9.

  • DTYPE (str hoặc numpy.dtype hoặc cặp của chúng, tùy chọn) - định dạng mẫu của

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    60 được cung cấp cho cuộc gọi lại luồng,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 hoặc
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54. Nó có thể là bất kỳ FLOAT32, INT32, INT16, INT8, UINT8. Xem
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    06. Kiểu dữ liệu Float64 không được hỗ trợ, điều này chỉ được hỗ trợ để thuận tiện trong ________ 24/________ 25/________ 26. Định dạng 24 bit được đóng gói
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    05 chỉ được hỗ trợ trong các lớp luồng Raw Raw, xem
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5. (Các) giá trị mặc định có thể được thay đổi với
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.
    (str or numpy.dtype or pair thereof, optional) – The sample format of the
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    60 provided to the stream callback,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 or
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54. It may be any of float32, int32, int16, int8, uint8. See
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    06. The float64 data type is not supported, this is only supported for convenience in
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    4/
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    5/
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    6. The packed 24 bit format
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    05 is only supported in the “raw” stream classes, see
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5. The default value(s) can be changed with
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1.

  • độ trễ (float hoặc {‘thấp,’ cao} hoặc cặp của chúng, tùy chọn) - độ trễ mong muốn tính bằng giây. Các giá trị đặc biệt

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    39 và
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    45 (sau là mặc định) chọn độ trễ thấp và cao mặc định, tương ứng (xem
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8). (Các) giá trị mặc định có thể được thay đổi với
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    36. Trong trường hợp thực tế, việc triển khai sẽ cấu hình độ trễ của chúng dựa trên tham số này, nếu không họ có thể chọn độ trễ khả thi gần nhất thay thế. Trừ khi độ trễ được đề xuất lớn hơn giới hạn trên tuyệt đối cho thiết bị, việc triển khai sẽ làm tròn độ trễ theo giá trị thực tế tiếp theo - tức là để cung cấp độ trễ bằng hoặc cao hơn bất cứ khi nào có thể. Các giá trị độ trễ thực tế cho một luồng mở có thể được truy xuất bằng thuộc tính
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    84.
    (float or {‘low’, ‘high’} or pair thereof, optional) – The desired latency in seconds. The special values
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    39 and
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    45 (latter being the default) select the default low and high latency, respectively (see
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    8). The default value(s) can be changed with
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    36. Where practical, implementations should configure their latency based on this parameter, otherwise they may choose the closest viable latency instead. Unless the suggested latency is greater than the absolute upper limit for the device, implementations should round the latency up to the next practical value – i.e. to provide an equal or higher latency wherever possible. Actual latency values for an open stream may be retrieved using the
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    84 attribute.

  • Extra_Sinstall (Cài đặt đối tượng hoặc cặp của chúng, tùy chọn)-Điều này có thể được sử dụng cho cài đặt đầu vào/đầu ra cụ thể của máy chủ-API. Xem

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    70. (settings object or pair thereof, optional) – This can be used for host-API-specific input/output settings. See
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    70.

  • Callback (Callable, Tùy chọn)-Hàm do người dùng cung cấp để tiêu thụ, xử lý hoặc tạo dữ liệu âm thanh để đáp ứng các yêu cầu từ luồng

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    43. Khi một luồng đang chạy, Portaudio gọi cuộc gọi lại luồng định kỳ. Hàm gọi lại chịu trách nhiệm xử lý và điền vào bộ đệm đầu vào và đầu ra tương ứng. (callable, optional) – User-supplied function to consume, process or generate audio data in response to requests from an
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    43 stream. When a stream is running, PortAudio calls the stream callback periodically. The callback function is responsible for processing and filling input and output buffers, respectively.

    Nếu không có cuộc gọi lại được đưa ra, luồng sẽ được mở trong chế độ đọc/ghi. Trong chế độ chặn, máy khách có thể nhận dữ liệu mẫu bằng cách sử dụng

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 và ghi dữ liệu mẫu bằng
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54, số lượng khung có thể được đọc hoặc viết mà không chặn được trả về bởi
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    79 và
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    80.

    Cuộc gọi lại phải có chữ ký này:

    callback(indata: ndarray, outdata: ndarray, frames: int,
             time: CData, status: CallbackFlags) -> None
    

    Đối số thứ nhất và thứ hai là bộ đệm đầu vào và đầu ra, tương ứng, khi

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    60 hai chiều với một cột trên mỗi kênh (tức là với hình dạng
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    82) và với kiểu dữ liệu được chỉ định bởi
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    83. Bộ đệm đầu ra chứa dữ liệu không chính thức và cuộc gọi lại được cho là sẽ điền vào nó bằng dữ liệu âm thanh phù hợp. Nếu không có dữ liệu, bộ đệm phải được lấp đầy bằng các số không (ví dụ: bằng cách sử dụng
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    84).

    Ghi chú

    Trong Python, việc gán cho một định danh chỉ đơn thuần là liên kết lại định danh cho một đối tượng khác, vì vậy điều này sẽ không hoạt động như mong đợi:

    outdata = my_data  # Don't do this!
    

    Để thực sự gán dữ liệu cho chính bộ đệm, bạn có thể sử dụng lập chỉ mục, ví dụ:

    outdata[:] = my_data
    

    Mạnh mà lấp đầy toàn bộ bộ đệm, hoặc:

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    0

    Mà chỉ điền vào một kênh.

    Đối số thứ ba giữ số lượng khung được xử lý bằng gọi lại luồng. Điều này giống như độ dài của bộ đệm đầu vào và đầu ra.

    Đối số Forth cung cấp cấu trúc CFFI với dấu thời gian cho thấy thời gian chụp ADC của mẫu đầu tiên trong bộ đệm đầu vào (

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    85), thời gian đầu ra DAC của mẫu đầu tiên trong bộ đệm đầu ra (
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    86) và thời gian gọi lại (
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    87 ). Các giá trị thời gian này được biểu thị bằng giây và được đồng bộ hóa với cơ sở thời gian được sử dụng bởi
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    88 cho luồng liên quan.

    Đối số thứ năm là một ví dụ

    >>> sd.default.channels = 1, 2
    
    4 cho biết liệu bộ đệm đầu vào và/hoặc đầu ra đã được chèn hay sẽ được giảm để vượt qua các điều kiện dòng chảy hoặc tràn.

    Nếu một ngoại lệ được nâng lên trong cuộc gọi lại, nó sẽ không được gọi lại. Nếu

    >>> sd.default.channels = 1, 2
    
    6 được nâng lên, luồng sẽ kết thúc càng sớm càng tốt. Nếu
    >>> sd.default.channels = 1, 2
    
    5 được nâng lên, luồng sẽ tiếp tục cho đến khi tất cả các bộ đệm được tạo bởi cuộc gọi lại đã được phát. Điều này có thể hữu ích trong các ứng dụng như trình phát Soundfile trong đó cần có thời lượng đầu ra cụ thể. Nếu một ngoại lệ khác được nâng lên, dấu vết của nó được in thành
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    92. Các trường hợp ngoại lệ không được truyền đến chủ đề chính, tức là chương trình Python chính tiếp tục chạy như thể không có gì xảy ra.

    Ghi chú

    Trong Python, việc gán cho một định danh chỉ đơn thuần là liên kết lại định danh cho một đối tượng khác, vì vậy điều này sẽ không hoạt động như mong đợi:

    Để thực sự gán dữ liệu cho chính bộ đệm, bạn có thể sử dụng lập chỉ mục, ví dụ:

    Mạnh mà lấp đầy toàn bộ bộ đệm, hoặc:

    Để một luồng duy trì hoạt động không bị trục trặc, cuộc gọi lại phải tiêu thụ và trả về dữ liệu âm thanh nhanh hơn so với được ghi và/hoặc phát. Portaudio dự đoán rằng mỗi lần gọi gọi lại có thể thực hiện trong một thời gian tiếp cận với thời lượng của các khung âm thanh khung ở tần số lấy mẫu luồng. Thật hợp lý khi hy vọng có thể sử dụng 70% hoặc nhiều hơn thời gian CPU có sẵn trong cuộc gọi lại Portaudio. Tuy nhiên, do sự thích nghi kích thước bộ đệm và các yếu tố khác, không phải tất cả các API của máy chủ đều có thể đảm bảo độ ổn định âm thanh dưới tải CPU nặng với kích thước bộ đệm gọi lại cố định tùy ý. Khi việc sử dụng CPU gọi lại cao được yêu cầu, hành vi mạnh mẽ nhất có thể đạt được bằng cách sử dụng

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    26.

  • Forew_callback (Callable, Tùy chọn)-Hàm do người dùng cung cấp sẽ được gọi khi luồng không hoạt động (nghĩa là một khi cuộc gọi đến

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 sẽ không chặn). (callable, optional) – User-supplied function which will be called when the stream becomes inactive (i.e. once a call to
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 will not block).

    Một luồng sẽ không hoạt động sau khi gọi lại luồng làm tăng một ngoại lệ hoặc khi

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 hoặc
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    94 được gọi. Đối với một luồng cung cấp đầu ra âm thanh, nếu gọi lại luồng tăng
    >>> sd.default.channels = 1, 2
    
    5 hoặc
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    8 được gọi, cuộc gọi lại hoàn thành luồng sẽ không được gọi cho đến khi tất cả dữ liệu mẫu được tạo đã được phát. Cuộc gọi lại phải có chữ ký này:

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    1

  • clip_off (bool, tùy chọn) - xem

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    03. (bool, optional) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    03.

  • Dither_off (Bool, Tùy chọn) - Xem

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    04. (bool, optional) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    04.

  • never_drop_input (bool, tùy chọn) - xem

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    05. (bool, optional) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    05.

  • Prime_output_buffers_using_stream_callback (bool, tùy chọn) - xem

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    06. (bool, optional) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    06.

________ 307 (bỏ qua_errors = true) ¶(ignore_errors=True)

Chấm dứt xử lý âm thanh ngay lập tức.

Điều này không chờ đợi cho bộ đệm đang chờ xử lý để hoàn thành.

________ 308¶

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 Khi luồng hoạt động,
>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
2 khác.

Một luồng đang hoạt động sau một cuộc gọi thành công đến

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
45, cho đến khi nó không hoạt động do kết quả của cuộc gọi đến
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
8 hoặc
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
94, hoặc là kết quả của một ngoại lệ được nêu trong cuộc gọi lại luồng. Trong trường hợp sau, luồng được xem xét không hoạt động sau khi bộ đệm cuối cùng chơi xong.

________ 215¶

Số lượng khung mỗi khối.

Giá trị đặc biệt 0 có nghĩa là khối khối có thể thay đổi giữa các khối. Xem đối số khối của

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2.

________ 189¶

Số lượng kênh đầu vào/đầu ra.

________ 317 (bỏ qua_errors = true) ¶(ignore_errors=True)

Đóng luồng.

Nếu luồng âm thanh hoạt động, bất kỳ bộ đệm đang chờ xử lý nào cũng bị loại bỏ như thể

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
94 đã được gọi.

________ 319¶

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 Sau khi gọi đến
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
48,
>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
2 khác.

________ 323¶

Thông tin sử dụng CPU cho luồng.

Tải trọng CPU CPU là một phần nhỏ của tổng thời gian CPU được tiêu thụ bởi các thói quen xử lý âm thanh của Stream Stream, bao gồm, nhưng không giới hạn ở cuộc gọi lại luồng do khách hàng cung cấp. Hàm này không hoạt động với việc chặn luồng đọc/ghi.

Điều này có thể được sử dụng trong chức năng gọi lại luồng hoặc trong ứng dụng. Nó cung cấp giá trị điểm nổi, thường là từ 0,0 đến 1,0, trong đó 1.0 chỉ ra rằng cuộc gọi lại luồng đang tiêu thụ số lượng chu kỳ CPU tối đa có thể để duy trì hoạt động thời gian thực. Giá trị 0,5 sẽ ngụ ý rằng Portaudio và gọi lại luồng tiêu thụ khoảng 50% thời gian CPU có sẵn. Giá trị có thể vượt quá 1.0. Giá trị 0,0 sẽ luôn được trả về cho luồng đọc/ghi chặn hoặc nếu xảy ra lỗi.

________ 188¶

ID của thiết bị đầu vào/đầu ra.

________ 191¶

Kiểu dữ liệu của các mẫu âm thanh.

________ 210¶

Độ trễ đầu vào/đầu ra của luồng tính bằng giây.

Giá trị này cung cấp ước tính chính xác nhất về độ trễ đầu vào/đầu ra có sẵn cho việc thực hiện. Nó có thể khác biệt đáng kể so với (các) giá trị độ trễ được truyền đến

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27.

________ 328 (khung)(frames)

Đọc các mẫu từ luồng vào một mảng numpy.

Hàm không trả lại cho đến khi tất cả các khung được yêu cầu đã được đọc - điều này có thể liên quan đến việc chờ hệ điều hành cung cấp dữ liệu (trừ khi không có nhiều hơn các khung

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
79 được yêu cầu).

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
30, ngoại trừ việc nó trả về một mảng numpy thay vì một đối tượng bộ đệm Python đơn giản.

Parameters:Khung (int) - Số lượng khung sẽ được đọc. Tham số này không bị giới hạn trong một phạm vi cụ thể, tuy nhiên các ứng dụng hiệu suất cao sẽ muốn khớp với tham số này với tham số khối được sử dụng khi mở luồng. (int) – The number of frames to be read. This parameter is not constrained to a specific range, however high performance applications will want to match this parameter to the blocksize parameter used when opening the stream.
Returns:
  • Dữ liệu (numpy.ndarray)-Một
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    60 hai chiều với một cột trên mỗi kênh (nghĩa là với hình dạng
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    82) và với kiểu dữ liệu được chỉ định bởi
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    83.
    (numpy.ndarray) – A two-dimensional
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    60 with one column per channel (i.e. with a shape of
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    82) and with a data type specified by
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    83.
  • đã bị tràn (bool) -
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3 nếu dữ liệu đầu vào bị loại bỏ bởi portaudio sau cuộc gọi trước và trước cuộc gọi này.
    (bool) –
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3 if input data was discarded by PortAudio after the previous call and before this call.
________ 335¶

Số lượng khung có thể được đọc mà không phải chờ đợi.

Trả về một giá trị đại diện cho số lượng khung tối đa có thể được đọc từ luồng mà không chặn hoặc bận chờ.

________ 214¶

Tần số lấy mẫu trong Hertz (= khung mỗi giây).

Trong trường hợp tần số lấy mẫu phần cứng không chính xác và Portaudio nhận thức được nó, giá trị của trường này có thể khác với tham số lấy mẫu được chuyển đến

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27. Nếu thông tin về tần số lấy mẫu phần cứng thực tế không có sẵn, trường này sẽ có cùng giá trị với tham số lấy mẫu được truyền đến
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27.

________ 339¶

Kích thước trong byte của một mẫu duy nhất.

________ 340 ()()

Bắt đầu xử lý âm thanh.

________ 92 (bỏ qua_errors = true) ¶(ignore_errors=True)

Chấm dứt xử lý âm thanh.

Điều này chờ đợi cho đến khi tất cả các bộ đệm âm thanh đang chờ xử lý đã được phát trước khi nó trở lại.

________ 342¶

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 Khi luồng được dừng lại,
>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
2 khác.

Một luồng được coi là dừng lại trước một cuộc gọi thành công đến

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
45 và sau một cuộc gọi thành công đến
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
8 hoặc
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
94. Nếu một cuộc gọi lại luồng bị hủy (bằng cách tăng một ngoại lệ), luồng không được coi là dừng.

________ 348¶

Thời gian luồng hiện tại tính bằng giây.

Đây là theo cùng một đồng hồ được sử dụng để tạo dấu thời gian được truyền với đối số thời gian cho cuộc gọi lại luồng (xem đối số gọi lại của

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2). Các giá trị thời gian đang tăng đơn điệu và có nguồn gốc không xác định.

Điều này cung cấp các giá trị thời gian hợp lệ cho toàn bộ tuổi thọ của luồng, từ khi luồng được mở cho đến khi nó được đóng lại. Bắt đầu và dừng luồng không ảnh hưởng đến thời gian trôi qua như được cung cấp ở đây.

Lần này có thể được sử dụng để đồng bộ hóa các sự kiện khác với luồng âm thanh, ví dụ như đồng bộ hóa âm thanh với MIDI.

________ 350 (dữ liệu) ¶(data)

Viết các mẫu vào luồng.

Chức năng này không trả lại cho đến khi toàn bộ bộ đệm được tiêu thụ - điều này có thể liên quan đến việc chờ hệ điều hành tiêu thụ dữ liệu (trừ khi dữ liệu chứa không quá

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
80 khung).

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
52, ngoại trừ việc nó mong đợi một mảng numpy thay vì một đối tượng bộ đệm Python đơn giản.

Parameters:

Dữ liệu (Array_like)-Một đối tượng giống như mảng hai chiều với một cột trên mỗi kênh (nghĩa là với hình dạng

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
82) và với kiểu dữ liệu được chỉ định bởi
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
83. Một mảng một chiều có thể được sử dụng cho dữ liệu đơn âm. Bố cục mảng phải là C-Con-Tiết (xem
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
55).
(array_like) – A two-dimensional array-like object with one column per channel (i.e. with a shape of
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
82) and with a data type specified by
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
83. A one-dimensional array can be used for mono data. The array layout must be C-contiguous (see
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
55).

Độ dài của bộ đệm không bị giới hạn trong một phạm vi cụ thể, tuy nhiên các ứng dụng hiệu suất cao sẽ muốn khớp với tham số này với tham số khối được sử dụng khi mở luồng.

Returns:

Nhập tải (bool) -

>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 nếu dữ liệu đầu ra bổ sung được chèn sau cuộc gọi trước đó và trước cuộc gọi này. (bool) –
>>> sd.default.device = 5
>>> sd.default.device
[5, 5]
3 if additional output data was inserted after the previous call and before this call.

________ 357¶

Số lượng khung có thể được viết mà không phải chờ đợi.

Trả về một giá trị đại diện cho số lượng khung tối đa có thể được ghi vào luồng mà không chặn hoặc bận chờ.

Lớp ________ 50 ________ 359 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶(samplerate=None, blocksize=None, device=None, channels=None, dtype=None, latency=None, extra_settings=None, callback=None, finished_callback=None, clip_off=None, dither_off=None, never_drop_input=None, prime_output_buffers_using_stream_callback=None)[source]

Mở một luồng đầu vào.

Điều này có các phương thức và thuộc tính tương tự như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, ngoại trừ
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
54 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
80. Hơn nữa, gọi lại luồng dự kiến ​​sẽ có một chữ ký khác (xem bên dưới).

Parameters:

Callback (Callable)-Hàm do người dùng cung cấp để tiêu thụ âm thanh để đáp ứng các yêu cầu từ luồng hoạt động. Cuộc gọi lại phải có chữ ký này: (callable) – User-supplied function to consume audio in response to requests from an active stream. The callback must have this signature:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
2

Các đối số giống như trong tham số gọi lại của

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, ngoại trừ OutData bị thiếu.

Lớp ________ 50 ________ 365 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶(samplerate=None, blocksize=None, device=None, channels=None, dtype=None, latency=None, extra_settings=None, callback=None, finished_callback=None, clip_off=None, dither_off=None, never_drop_input=None, prime_output_buffers_using_stream_callback=None)[source]

Mở một luồng đầu ra.

Điều này có các phương thức và thuộc tính tương tự như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, ngoại trừ
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
53 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
79. Hơn nữa, gọi lại luồng dự kiến ​​sẽ có một chữ ký khác (xem bên dưới).

Parameters:

Callback (Callable)-Hàm do người dùng cung cấp để tạo dữ liệu âm thanh để đáp ứng các yêu cầu từ luồng hoạt động. Cuộc gọi lại phải có chữ ký này: (callable) – User-supplied function to generate audio data in response to requests from an active stream. The callback must have this signature:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
3

Các đối số giống như trong tham số gọi lại của

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, ngoại trừ indata bị thiếu.

Lớp ________ 50 ________ 371 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶(samplerate=None, blocksize=None, device=None, channels=None, dtype=None, latency=None, extra_settings=None, callback=None, finished_callback=None, clip_off=None, dither_off=None, never_drop_input=None, prime_output_buffers_using_stream_callback=None)[source]

Mở một luồng đầu vào/đầu ra của Raw Raw.

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2, ngoại trừ chức năng gọi lại và ________ 253/________ 254 hoạt động trên các đối tượng bộ đệm Python đơn giản thay vì trên các mảng Numpy. Numpy là không cần thiết để sử dụng điều này.

Để mở một lần sử dụng luồng chỉ đầu vào chỉ đầu vào hoặc chỉ sử dụng luồng chỉ đầu ra

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
6 hoặc
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
7. Nếu bạn muốn xử lý dữ liệu âm thanh dưới dạng mảng numpy thay vì các đối tượng bộ đệm, hãy sử dụng
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
2,
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
3 hoặc
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4.

Parameters:
  • DTYPE (STR hoặc cặp STR) - Định dạng mẫu của các bộ đệm được cung cấp cho gọi lại luồng,

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 hoặc
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54. Ngoài các định dạng được hỗ trợ bởi
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    2 (
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    92,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    93,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    94,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    95,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    96), điều này cũng hỗ trợ
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    05, tức là định dạng 24 bit đóng gói. Giá trị mặc định có thể được thay đổi với
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1. Xem thêm
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    90.
    (str or pair of str) – The sample format of the buffers provided to the stream callback,
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    53 or
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    54. In addition to the formats supported by
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    2 (
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    92,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    93,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    94,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    95,
    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    96), this also supports
    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    05, i.e. packed 24 bit format. The default value can be changed with
    >>> sd.default.samplerate = None
    >>> sd.default.device = None, 4
    
    1. See also
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    90.

  • Callback (Callable)-Hàm do người dùng cung cấp để tiêu thụ, xử lý hoặc tạo dữ liệu âm thanh để đáp ứng các yêu cầu từ luồng hoạt động. Cuộc gọi lại phải có chữ ký này: (callable) – User-supplied function to consume, process or generate audio data in response to requests from an active stream. The callback must have this signature:

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    4

    Các đối số giống như trong tham số gọi lại của

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    2, ngoại trừ indata và outdata là các đối tượng bộ đệm python đơn giản thay vì các mảng numpy.

________ 328 (khung)(frames)

Đọc các mẫu từ luồng vào một bộ đệm.

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
93, ngoại trừ việc nó trả về một đối tượng bộ đệm Python đơn giản thay vì một mảng numpy. Numpy là không cần thiết để sử dụng điều này.

Parameters:Khung (int) - Số lượng khung sẽ được đọc. Xem
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
93.
(int) – The number of frames to be read. See
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
93.
Returns:
  • Dữ liệu (bộ đệm) - Một bộ đệm của các mẫu xen kẽ. Bộ đệm chứa các mẫu ở định dạng được chỉ định bởi tham số DTYPE được sử dụng để mở luồng và số lượng kênh được chỉ định bởi các kênh. Xem thêm
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    90.
    (buffer) – A buffer of interleaved samples. The buffer contains samples in the format specified by the dtype parameter used to open the stream, and the number of channels specified by channels. See also
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    90.
  • Thoát điện (Bool) - Xem
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    93.
    (bool) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    93.
________ 350 (dữ liệu) ¶(data)

Viết các mẫu vào luồng.

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
98, ngoại trừ việc nó mong đợi một đối tượng bộ đệm Python đơn giản thay vì một mảng numpy. Numpy là không cần thiết để sử dụng điều này.

Parameters:Dữ liệu (bộ đệm hoặc byte hoặc có thể lặp lại của int) - một bộ đệm của các mẫu xen kẽ. Bộ đệm chứa các mẫu ở định dạng được chỉ định bởi đối số DTYPE được sử dụng để mở luồng và số lượng kênh được chỉ định bởi các kênh. Độ dài của bộ đệm không bị giới hạn trong một phạm vi cụ thể, tuy nhiên các ứng dụng hiệu suất cao sẽ muốn khớp với tham số này với tham số khối được sử dụng khi mở luồng. Xem thêm
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
90.
(buffer or bytes or iterable of int) – A buffer of interleaved samples. The buffer contains samples in the format specified by the dtype argument used to open the stream, and the number of channels specified by channels. The length of the buffer is not constrained to a specific range, however high performance applications will want to match this parameter to the blocksize parameter used when opening the stream. See also
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
90.
Returns:Nhập tải (Bool) - Xem
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
98.
(bool) – See
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
98.
Lớp ________ 50 ________ 402 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶(samplerate=None, blocksize=None, device=None, channels=None, dtype=None, latency=None, extra_settings=None, callback=None, finished_callback=None, clip_off=None, dither_off=None, never_drop_input=None, prime_output_buffers_using_stream_callback=None)[source]

Mở một luồng đầu vào của Raw Raw.

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
3, ngoại trừ chức năng gọi lại và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
53 hoạt động trên các đối tượng bộ đệm Python đơn giản thay vì trên các mảng Numpy. Numpy là không cần thiết để sử dụng điều này.

Parameters:
  • DTYPE (STR) - Xem

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5. (str) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5.

  • Callback (Callable)-Hàm do người dùng cung cấp để tiêu thụ dữ liệu âm thanh để đáp ứng các yêu cầu từ luồng hoạt động. Cuộc gọi lại phải có chữ ký này: (callable) – User-supplied function to consume audio data in response to requests from an active stream. The callback must have this signature:

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    5

    Các đối số giống như trong tham số gọi lại của

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5, ngoại trừ OutData bị thiếu.

Lớp ________ 50 ________ 408 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶(samplerate=None, blocksize=None, device=None, channels=None, dtype=None, latency=None, extra_settings=None, callback=None, finished_callback=None, clip_off=None, dither_off=None, never_drop_input=None, prime_output_buffers_using_stream_callback=None)[source]

Mở một luồng đầu ra của Raw Raw.

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4, ngoại trừ chức năng gọi lại và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
54 hoạt động trên các đối tượng bộ đệm Python đơn giản thay vì trên các mảng Numpy. Numpy là không cần thiết để sử dụng điều này.

Parameters:
  • DTYPE (STR) - Xem

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5. (str) – See
    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5.

  • Callback (Callable)-Hàm do người dùng cung cấp để tiêu thụ dữ liệu âm thanh để đáp ứng các yêu cầu từ luồng hoạt động. Cuộc gọi lại phải có chữ ký này: (callable) – User-supplied function to generate audio data in response to requests from an active stream. The callback must have this signature:

    >>> sd.query_devices()
      0 Built-in Line Input, Core Audio (2 in, 0 out)
    > 1 Built-in Digital Input, Core Audio (2 in, 0 out)
    < 2 Built-in Output, Core Audio (0 in, 2 out)
      3 Built-in Line Output, Core Audio (0 in, 2 out)
      4 Built-in Digital Output, Core Audio (0 in, 2 out)
    
    6

    Các đối số giống như trong tham số gọi lại của

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    5, ngoại trừ OutData bị thiếu.

Lớp ________ 50 ________ 408 (SampleRate = none, blockSize = none, device = none, scores = none, dtype = none, latency = none , Prime_output_buffers_using_stream_callback = none) [Nguồn] ¶[source]

Mở một luồng đầu ra của Raw Raw.

Điều này giống như

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
4, ngoại trừ chức năng gọi lại và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
54 hoạt động trên các đối tượng bộ đệm Python đơn giản thay vì trên các mảng Numpy. Numpy là không cần thiết để sử dụng điều này.

Callback (Callable)-Hàm do người dùng cung cấp để tạo dữ liệu âm thanh để đáp ứng các yêu cầu từ luồng hoạt động. Cuộc gọi lại phải có chữ ký này:

Lớp ________ 50 ________ 422 (cờ = 0) [Nguồn] ¶(flags=0)[source]

BIT cờ cho đối số trạng thái vào một cuộc gọi lại luồng.

Ví dụ

Điều này có thể được sử dụng để thu thập các lỗi của nhiều đối tượng trạng thái:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
7

________ 423¶

Đầu vào Dòng chảy.

Trong một luồng được mở với

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
26, chỉ ra rằng dữ liệu đầu vào là tất cả sự im lặng (số không) vì không có dữ liệu thực. Trong một luồng được mở bằng một khối không khác, nó chỉ ra rằng một hoặc nhiều mẫu bằng 0 đã được chèn vào bộ đệm đầu vào để bù cho một dòng chảy đầu vào.

Điều này chỉ có thể xảy ra trong các luồng song công đầy đủ (bao gồm

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6).

________ 426¶

Tràn đầu vào.

Trong một luồng được mở bằng

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
26, chỉ ra rằng dữ liệu trước mẫu đầu tiên của bộ đệm đầu vào đã bị loại bỏ do tràn, có thể là do gọi lại luồng đang sử dụng quá nhiều thời gian CPU. Nếu không chỉ ra rằng dữ liệu trước một hoặc nhiều mẫu trong bộ đệm đầu vào đã bị loại bỏ.

Điều này có thể xảy ra trong các luồng toàn diện và chỉ đầu vào (bao gồm

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
5).

________ 430¶

Đầu ra tràn.

Cho biết rằng dữ liệu đầu ra (hoặc một khoảng cách) đã được chèn, có thể do cuộc gọi lại luồng đang sử dụng quá nhiều thời gian CPU.

Điều này có thể xảy ra trong các luồng toàn diện và chỉ đầu ra (bao gồm

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6 và
(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4).

________ 433¶

Đầu ra tràn.

Cho biết rằng dữ liệu đầu ra sẽ bị loại bỏ vì không có phòng.

Điều này chỉ có thể xảy ra trong các luồng song công đầy đủ (bao gồm

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
6), nhưng chỉ khi
>>> sd.default.channels = 1, 2
35 được chỉ định. Xem
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
05.

________ 437¶

Sản lượng mồi.

Một số dữ liệu đầu ra sẽ được sử dụng để điều khiển luồng, dữ liệu đầu vào có thể bằng không.

Điều này sẽ chỉ diễn ra với một số API máy chủ và chỉ khi

>>> sd.default.channels = 1, 2
38 được chỉ định. Xem
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
06.

Lớp ________ 50 ________ 441 [Nguồn] ¶[source]

Ngoại lệ được người dùng nâng lên để ngừng xử lý gọi lại.

Nếu điều này được nêu trong cuộc gọi lại luồng, cuộc gọi lại sẽ không được gọi nữa (nhưng tất cả các bộ đệm âm thanh đang chờ xử lý sẽ được phát).

Lớp ________ 50 ________ 443 [Nguồn] ¶[source]

Ngoại lệ được người dùng đưa ra để hủy bỏ xử lý gọi lại.

Nếu điều này được nâng lên trong cuộc gọi lại luồng, tất cả các bộ đệm đang chờ xử lý sẽ bị loại bỏ và cuộc gọi lại sẽ không được gọi nữa.

Lớp ________ 50 ________ 445 [Nguồn] ¶[source]

Ngoại lệ này sẽ được nêu ra trên các lỗi của Portaudio.

________ 446¶

Một tuple có độ dài thay đổi chứa các yếu tố sau khi có sẵn:

  1. Một chuỗi mô tả lỗi
  2. Giá trị portaudio
    >>> sd.default.channels = 1, 2
    
    47
  3. 3-tuple chứa chỉ mục API máy chủ, mã lỗi máy chủ và thông báo lỗi máy chủ (có thể là một chuỗi trống)
Lớp ________ 50 ________ 449 (Channel_selectors) [Nguồn] ¶(channel_selectors)[source]

Cài đặt đầu vào/đầu ra cụ thể ASIO.

Các đối tượng của lớp này có thể được sử dụng làm đối số thêm_Sinstall thành

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27 (và các biến thể) hoặc là
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
70.

Parameters:Channel_selectors (Danh sách INT) - Hỗ trợ chỉ mở các kênh cụ thể của thiết bị ASIO. Channel_selectors là danh sách các số nguyên chỉ định số kênh (dựa trên không) để sử dụng. Độ dài của kênh_selector phải khớp với tham số kênh tương ứng của
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27 (hoặc các biến thể), nếu không một sự cố có thể xảy ra. Các giá trị trong mảng Channel_selector phải chỉ định các kênh trong phạm vi của các kênh được hỗ trợ.
(list of int) – Support for opening only specific channels of an ASIO device. channel_selectors is a list of integers specifying the (zero-based) channel numbers to use. The length of channel_selectors must match the corresponding channels parameter of
>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27 (or variants), otherwise a crash may result. The values in the channel_selectors array must specify channels within the range of supported channels.

Ví dụ

Đặt kênh đầu ra khi gọi

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
8

Cài đặt kênh đầu ra mặc định:

>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
9

Cài đặt các kênh đầu vào là tốt:

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
0

Lớp ________ 50 ________ 455 (channel_map = none, thay đổi_device_parameter = false, fail_if_conversion_required = false(channel_map=None, change_device_parameters=False, fail_if_conversion_required=False, conversion_quality='max')[source]

MAC Core Core Audio dành riêng cho cài đặt đầu vào/đầu ra.

Các đối tượng của lớp này có thể được sử dụng làm đối số thêm_Sinstall thành

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27 (và các biến thể) hoặc là
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
70.

Parameters:
  • Channel_selectors (Danh sách INT) - Hỗ trợ chỉ mở các kênh cụ thể của thiết bị ASIO. Channel_selectors là danh sách các số nguyên chỉ định số kênh (dựa trên không) để sử dụng. Độ dài của kênh_selector phải khớp với tham số kênh tương ứng của

    >>> import sounddevice as sd
    >>> sd.default.samplerate = 48000
    >>> sd.default.dtype
    ['float32', 'float32']
    
    27 (hoặc các biến thể), nếu không một sự cố có thể xảy ra. Các giá trị trong mảng Channel_selector phải chỉ định các kênh trong phạm vi của các kênh được hỗ trợ. (sequence of int, optional) – Support for opening only specific channels of a Core Audio device. Note that channel_map is treated differently between input and output channels.

    Đặt kênh đầu ra khi gọi

    (1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
    
    4:

    Cài đặt kênh đầu ra mặc định:

    Cài đặt các kênh đầu vào là tốt:

  • Lớp ________ 50 ________ 455 (channel_map = none, thay đổi_device_parameter = false, fail_if_conversion_required = false (bool, optional) – If

    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3, allows PortAudio to change things like the device’s frame size, which allows for much lower latency, but might disrupt the device if other programs are using it, even when you are just querying the device.
    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    2 is the default.

  • MAC Core Core Audio dành riêng cho cài đặt đầu vào/đầu ra. (bool, optional) – In combination with the above flag,

    >>> sd.default.device = 5
    >>> sd.default.device
    [5, 5]
    
    3 causes the stream opening to fail, unless the exact sample rates are supported by the device.

  • Chuyển đổi_quality ({‘min,’ thấp, ’trung bình,’ cao, ‘tối đa}, tùy chọn) - điều này đặt ra chất lượng chuyển đổi tốc độ mẫu âm thanh cốt lõi.

    >>> sd.default.channels = 1, 2
    
    61 là mặc định. ({‘min’, ‘low’, ‘medium’, ‘high’, ‘max’}, optional) – This sets Core Audio’s sample rate conversion quality.
    >>> sd.default.channels = 1, 2
    
    61 is the default.

Thí dụ

Ví dụ này giả định một thiết bị có 6 kênh đầu vào và 6 kênh đầu ra.Đầu vào là từ các kênh thứ hai và thứ tư và đầu ra là các kênh thứ ba và thứ năm của thiết bị:

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
1

Lớp ________ 50 ________ 463 (độc quyền = false) [Nguồn] ¶(exclusive=False)[source]

Cài đặt đầu vào/đầu ra dành riêng cho Wasapi.

Các đối tượng của lớp này có thể được sử dụng làm đối số thêm_Sinstall thành

>>> import sounddevice as sd
>>> sd.default.samplerate = 48000
>>> sd.default.dtype
['float32', 'float32']
27 (và các biến thể) hoặc là
>>> sd.query_devices()
  0 Built-in Line Input, Core Audio (2 in, 0 out)
> 1 Built-in Digital Input, Core Audio (2 in, 0 out)
< 2 Built-in Output, Core Audio (0 in, 2 out)
  3 Built-in Line Output, Core Audio (0 in, 2 out)
  4 Built-in Digital Output, Core Audio (0 in, 2 out)
70.Chúng cũng có thể được sử dụng trong
>>> sd.default.channels = 1, 2
0 và
>>> sd.default.channels = 1, 2
1.

Parameters:ĐỘC QUYỀN (BOOL) - Chế độ độc quyền cho phép cung cấp dữ liệu âm thanh trực tiếp cho phần mềm bỏ qua phần mềm. (bool) – Exclusive mode allows to deliver audio data directly to hardware bypassing software mixing.

Ví dụ

Đặt chế độ độc quyền khi gọi

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
4:

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
2

Đặt chế độ độc quyền làm mặc định:

(1899, 'PortAudio V19-devel (built Feb 15 2014 23:28:00)')
3