audioread
オーディオ ファイルの読み取り
説明
例
オーディオ ファイル全体を読み取る
例のファイル handel.mat
から WAVE ファイルを作成し、この WAVE ファイルを再び MATLAB® 内に読み取ります。
現在のフォルダーに WAVE (.wav
) ファイルを作成します。
load handel.mat filename = 'handel.wav'; audiowrite(filename,y,Fs); clear y Fs
audioread
を使用してデータを再び MATLAB 内に読み取ります。
[y,Fs] = audioread('handel.wav');
オーディオを再生します。
sound(y,Fs);
オーディオ ファイルの一部を読み取る
例のファイル handel.mat
から FLAC ファイルを作成し、最初の 2 秒のみを読み取ります。
現在のフォルダーに FLAC (.flac
) ファイルを作成します。
load handel.mat filename = 'handel.flac'; audiowrite(filename,y,Fs);
最初の 2 秒のみを読み取ります。
samples = [1,2*Fs]; clear y Fs [y,Fs] = audioread(filename,samples);
サンプルを再生します。
sound(y,Fs);
オーディオをネイティブの整数形式で返す
.flac
ファイルを作成し、ファイルの最初の 2 秒を読み取ってから、オーディオをネイティブの整数形式で返します。
現在のフォルダーに FLAC (.flac
) ファイルを作成します。
load handel.mat filename = 'handel.flac'; audiowrite(filename,y,Fs);
最初の 2 秒のみを読み取り、データを指定して、サンプル データ y のデータ型を表示します。y
のデータ型は double
です。
samples = [1,2*Fs]; clear y Fs [y,Fs] = audioread(filename,samples); whos y
Name Size Bytes Class Attributes y 16384x1 131072 double
ネイティブ ファイル形式のオーディオ データを要求し、サンプル データ y
のデータ型を表示します。y
の新しいデータ型を確認します。
[y,Fs] = audioread(filename,'native'); whos y
Name Size Bytes Class Attributes y 73113x1 146226 int16
入力引数
filename
— 読み取るファイルの名前
文字ベクトル | string スカラー
読み取るファイルの名前。ファイル拡張子を含む文字ベクトルまたは string スカラーとして指定します。
ファイルの場所によって、filename
は次のいずれかの形式をとります。
現在のフォルダー | ファイル名を 例: | ||||||||
その他のフォルダー | ファイルが現在のフォルダーまたは MATLAB® パス上のフォルダーにない場合は、 例: 例: | ||||||||
インターネット URL | ファイルをインターネットの Uniform Resource Locator (URL) として指定する場合、 例: | ||||||||
リモートの場所 | リモートの場所に保存されたファイルの場合、
リモートの場所に基づいて、
詳細については、リモート データの操作を参照してください。 例: |
例: 'myFile.mp3'
例: '../myFile.mp3'
例: 'C:\temp\myFile.mp3'
audioread
は次のファイル形式をサポートします。
サポートされているプラットフォーム | ファイル形式 |
---|---|
すべてのプラットフォーム | AIFC (.aifc ) |
AIFF (.aiff 、.aif ) | |
AU (.au ) | |
FLAC (.flac ) | |
OGG (.ogg ) | |
OPUS (.opus ) | |
WAVE (.wav ) | |
Windows® 7 以降、Macintosh、および Linux® | MP3 (.mp3 ) |
MPEG-4 AAC (.m4a 、.mp4 ) |
Windows 7 より前の Windows プラットフォームでは、audioread
は MP3 でエンコードされたデータを含む WAVE ファイルを読み取りません。
Windows 7 以降のプラットフォームでは、audioread
は Windows Media® Foundation によってサポートされるすべてのファイルも読み取ることができます。
Linux プラットフォームでは、audioread
は GStreamer によってサポートされるすべてのファイルも読み取ることができます。
audioread
は、Windows 7 以降、Macintosh、および Linux 上の MPEG-4 (.mp4
、.m4v
) ビデオ ファイルから、また Windows 7 以降および Linux プラットフォーム上の Windows Media ビデオ (.wmv
) および AVI (.avi
) ファイルからオーディオを抽出できます。
データ型: char
| string
samples
— 読み取り対象のオーディオ サンプル
[1,inf]
(既定値) | 正のスカラー整数の 2 要素ベクトル
[start,finish]
の形式の 2 要素ベクトルとして指定する読み取り対象のオーディオ サンプル。この start
と finish
は最初と最後に読み取られるサンプルで、共に正のスカラー整数です。
start
はfinish
以下でなければなりません。start
とfinish
はファイル内のオーディオ サンプル数未満でなければなりません。ファイル内の最後のサンプルを指定するには
inf
を使用できます。
メモ
audioread
が、Windows 7 または Windows 10 プラットフォームでいくつかの MP3 ファイルの一部を読み取る場合に、サンプルの読み取り範囲が少し移動することがあります。これは基盤となる Windows Media Foundation フレームワークの制限によるものです。
audioread
が、Linux プラットフォームの MP3 および M4A ファイルの一部を読み取る場合に、サンプルを読み取る範囲が少し移動することがあります。これは基盤となる GStreamer フレームワークの制限によるものです。
例: [1,100]
データ型: double
dataType
— オーディオ データ y
のデータ形式
'double'
(既定値) | 'native'
オーディオ データ y
のデータ形式。以下のいずれかとして指定します。
'double' | 倍精度の正規化されたサンプル |
'native' | ファイルにあるネイティブ形式のサンプル |
整数形式でデータを格納しない MP3 や MPEG-4 AAC などの圧縮オーディオ形式の場合、'native'
の既定の設定は 'single'
になります。
データ型: char
| string
出力引数
y
— オーディオ データ
行列
m
行 n
列の行列として返される、ファイル内のオーディオ データ。ここで、m
は読み取られたオーディオ サンプル数、n
はファイル内のオーディオ チャネル数です。
dataType
を指定しない場合、あるいはdataType
が'double'
の場合、y
はdouble
型になり、行列要素は −1.0 から 1.0 までの正規化された値になります。dataType
が'native'
の場合、y
は入力ファイルのファイル形式およびBitsPerSample
値に応じて MATLAB の複数のデータ型のいずれかになります。このファイルのBitsPerSample
値を判別するには、audioinfo
を呼び出します。ファイル形式 BitsPerSample y のデータ型 y のデータ範囲 WAVE ( .wav
)8 uint8
0 ≤ y
≤ 25516 int16
-32768 ≤ y
≤ +3276724 int32
-2^31 ≤ y
≤ 2^31–132 int32
-2^31 ≤ y
≤ 2^31–132 single
-1.0 ≤ y
≤ +1.064 double
-1.0 ≤ y
≤ +1.0WAVE ( .wav
) (u 則)8 int16
-32124 ≤ y
≤ +32124WAVE ( .wav
) (A 則)8 int16
-32256 ≤ y
≤ +32256FLAC ( .flac
)8 uint8
0 ≤ y
≤ 25516 int16
-32768 ≤ y
≤ +3276724 int32
-2^31 ≤ y
≤ 2^31–1MP3 ( .mp3
)、MPEG-4 AAC (.m4a
、.mp4
)、OGG (.ogg
)、OPUS (.opus
) および圧縮された特定の WAVE ファイルN/A single
-1.0 ≤ y
≤ +1.0
メモ
y
が single
または double
で、BitsPerSample
が 32 または 64 の場合、y
の値は −1.0 ~ +1.0 の範囲外になることがあります。
Fs
— サンプル レート
正のスカラー
正のスカラーとして返される、オーディオ データ y
のサンプル レート (Hz)
制限
Windows 7 以降および Linux プラットフォーム上の MP3、MPEG-4 AAC、および AVI オーディオ ファイルでは、
audioread
の読み取るサンプル数は想定より少なくなる可能性があります。Windows 7 プラットフォームの場合、これは基盤となる Media Foundation フレームワークの制限によるものです。Linux プラットフォームの場合、これは基盤となる GStreamer フレームワークの制限によるものです。サンプル数分の正確な読み取りが必要な場合は、WAV または FLAC ファイルを使用してください。Linux プラットフォームでは、
audioread
はステレオ データとして 1 つのチャネル データを含む MPEG-4 AAC ファイルを読み取ります。
拡張機能
スレッドベースの環境
MATLAB® の backgroundPool
を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool
を使用してコードを高速化します。
この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。
バージョン履歴
R2012b で導入R2022a: Opus (.opus
) オーディオ ファイルの読み取り
Ogg Opus オーディオ ファイルを読み取ることができます。
R2021b: スレッドベースの環境のサポート
MATLAB backgroundPool
を使用して、バックグラウンドで audioread
を実行できます。
R2021a: HTTP または HTTPS URL からのオーディオ ファイルの読み取り
プロトコル タイプ 'http://'
または 'https://'
が含まれた string または文字ベクトルとして filename
を指定して、インターネット URL からオーディオ ファイルを読み取ることができます。
R2020b: リモートの場所からのオーディオ ファイルの読み取り
Amazon S3、Windows Azure Blob Storage、HDFS などのリモートの場所に保存されたオーディオ ファイルを読み取ることができます。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)