From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/audiobuffersourcenode/index.html | 234 ++++++++++++++++++++++ 1 file changed, 234 insertions(+) create mode 100644 files/ja/web/api/audiobuffersourcenode/index.html (limited to 'files/ja/web/api/audiobuffersourcenode/index.html') diff --git a/files/ja/web/api/audiobuffersourcenode/index.html b/files/ja/web/api/audiobuffersourcenode/index.html new file mode 100644 index 0000000000..709bc6abbf --- /dev/null +++ b/files/ja/web/api/audiobuffersourcenode/index.html @@ -0,0 +1,234 @@ +--- +title: AudioBufferSourceNode +slug: Web/API/AudioBufferSourceNode +translation_of: Web/API/AudioBufferSourceNode +--- +

{{APIRef("Web Audio API")}}

+ +
+

AudioBufferSourceNodeは{{domxref("AudioScheduledSourceNode")}}を継承するインタフェースで、{{domxref("AudioBuffer")}}に保存されたインメモリ音声データからなるオーディオソースを表します。AudioBufferSourceNodeは、再生するタイミングに高い正確性が求められる音声を繰り返し再生する場合特に有益です。例えば、特定のリズムに合わせて、ディスクやネットワークからではなくメモリから読みだした音声を再生するといった場合です。正確なタイミングで音声を再生したいものの、音声データがディスクやネットワークから読み込まれる必要がある場合は{{domxref("AudioWorkletNode")}}を使用してください。

+ +

{{InheritanceDiagram(600, 140)}}

+ +

AudioBufferSourceNode は入力がなく、その出力は 1 つで、出力されるチャンネル数は AudioBufferSourceNode.buffer で参照される {{domxref("AudioBuffer")}} のチャンネル数によって決まります。この属性値が NULL の場合、つまりバッファがセットされていない場合、無音が出力されます。{{domxref("AudioBufferSourceNode")}}は一度しか再生できません。つまり、AudioBufferSourceNode.start()の呼び出しは一度しかできません。もし、再び再生するならば、別のAudioBufferSourceNodeを生成する必要があります。これらのノードは安価に生成でき、AudioBufferは何度も再生できます。よくAudioBufferSourceNodeは「撃ちっぱなし」で使わなければならない、と言われます。つまり、一度再生を始めると、そのノードへの参照はなくなり、自動的にガベージコレクトされます。

+
+ +

AudioBufferSourceNode.stop()は何度も呼ぶことができます。AudioBufferSourceNodeがバッファの最後に達していないならば、最後の呼び出しがその前の呼び出しを上書きします。

+ +


+ The AudioBufferSourceNode takes the content of an AudioBuffer and m

+ + + + + + + + + + + + + + + + +
Number of inputs0
Number of outputs1
Channel countdefined by the associated {{domxref("AudioBuffer")}}
+ +

コンストラクタ

+ +
+
{{domxref("AudioBufferSourceNode.AudioBufferSourceNode", "AudioBufferSourceNode()")}}
+
AudioBufferSourceNode オブジェクトを新しく作成して返します。{{domxref("AudioBufferSourceNode")}}は{{domxref("AudioContext.createBufferSource()")}}メソッドを用いてインスタンス化することができます。
+
+ +

プロパティ

+ +

親である{{domxref("AudioNode")}}のプロパティを継承しています。

+ +
+
{{domxref("AudioBufferSourceNode.buffer")}}
+
再生される音声の{{domxref("AudioBuffer")}}です。NULLの場合1チャンネルからなる無音の音声（すべてのサンプルが0.0）です。
+
{{domxref("AudioBufferSourceNode.detune")}}
+
セント単位のデチューンを表すk-rate{{domxref("AudioParam")}}です。この値とplaybackRateの組み合わせで音声が再生される速度が決定されます。デフォルト値は0（デチューンなし）で、公称範囲は -∞ から ∞ です。
+
{{domxref("AudioBufferSourceNode.loop")}}
+
{{domxref("AudioBuffer")}}の最後に達したとき再び再生するかを表すブール値です。デフォルトはfalseです。
+
{{domxref("AudioBufferSourceNode.loopStart")}} {{optional_inline}}
+
loopがtrueのとき、{{domxref("AudioBuffer")}}を再び再生する位置(秒単位)を表す浮動小数点数です。デフォルトは0で、これは音声の初めからループが始まることを意味します。
+
{{domxref("AudioBufferSourceNode.loopEnd")}} {{optional_inline}}
+
loopがtrueのとき、{{domxref("AudioBuffer")}}の再生を停止してloopStartの地点に戻る位置(秒単位)を表す浮動小数点数です。デフォルトは0です。
+
{{domxref("AudioBufferSourceNode.playbackRate")}}
+
再生される音声の速度要素を表すa-rate{{domxref("AudioParam")}}です。この値が1.0のとき通常のサンプリングレートで出力されます。出力にピッチの修正が適用されない場合は、サンプルのピッチの変更に使うことができます。この値とdetuneの組み合わせで音声が再生される速度が決定されます。
+
+ +

イベントハンドラ

+ +

親である{{domxref("AudioScheduledSourceNode")}}のイベントハンドラを継承しています。

+ +
+
{{domxref("AudioBufferSourceNode.onended")}}
+
{{event("ended_(Web_Audio)", "ended")}}イベントに関するコールバックを格納したイベントハンドラです。
+
+ +

メソッド

+ +

親である{{domxref("AudioNode")}}のメソッドを継承しています。

+ +
+
{{domxref("AudioBufferSourceNode.start()")}}
+
設定された音声の再生をスケジュールするか、直ちに再生します。
+
{{domxref("AudioBufferSourceNode.stop()")}}
+
設定された音声の再生の停止をスケジュールするか、直ちに停止します。
+
+ +

例

+ +

次の例は、2秒間のバッファを生成し、ホワイトノイズを書き込み、AudioBufferSourceNodeで再生します。コメントは何をしているかを簡単に説明しています。

+ +
+

注: コードをすぐに実行することや、ソースコードを閲覧することもできます。

+
+ +
var audioCtx = new (window.AudioContext || window.webkitAudioContext)();
+var button = document.querySelector('button');
+var pre = document.querySelector('pre');
+var myScript = document.querySelector('script');
+
+pre.innerHTML = myScript.innerHTML;
+
+// ステレオ
+var channels = 2;
+// AudioContextのサンプルレートで2秒間の空のステレオバッファを生成する
+var frameCount = audioCtx.sampleRate * 2.0;
+
+var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
+
+button.onclick = function() {
+  // バッファにホワイトノイズを書き込む;
+  // 単なる-1.0から1.0の間の乱数の値である
+  for (var channel = 0; channel < channels; channel++) {
+   // 実際のデータの配列を得る
+   var nowBuffering = myArrayBuffer.getChannelData(channel);
+   for (var i = 0; i < frameCount; i++) {
+     // Math.random()は[0; 1.0]である
+     // 音声は[-1.0; 1.0]である必要がある
+     nowBuffering[i] = Math.random() * 2 - 1;
+   }
+  }
+
+  // AudioBufferSourceNodeを得る
+  // これはAudioBufferを再生するときに使うAudioNodeである
+  var source = audioCtx.createBufferSource();
+  // AudioBufferSourceNodeにバッファを設定する
+  source.buffer = myArrayBuffer;
+  // AudioBufferSourceNodeを出力先に接続すると音声が聞こえるようになる
+  source.connect(audioCtx.destination);
+  // 音源の再生を始める
+  source.start();
+}
+ +
+

注: decodeAudioDataの例は、{{domxref("AudioContext.decodeAudioData")}}のページを参照してください。

+
+ +

仕様

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('Web Audio API', '#AudioBufferSourceNode-section', 'AudioBufferSourceNode')}}{{Spec2('Web Audio API')}} 
+ +

ブラウザ互換性

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support14 {{property_prefix("webkit")}}{{CompatGeckoDesktop("23.0")}}{{CompatNo}}15 {{property_prefix("webkit")}}
+ 22		6 {{property_prefix("webkit")}}
detune property{{CompatVersionUnknown}}{{CompatGeckoDesktop("40.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChromeFirefox Mobile (Gecko)Firefox OSIE PhoneOpera MobileSafari Mobile
Basic support{{CompatNo}}28 {{property_prefix("webkit")}}{{CompatGeckoMobile("25.0")}}1.2{{CompatNo}}{{CompatNo}}6 {{property_prefix("webkit")}}
detune property{{CompatNo}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatUnknown}}
+ +

Chrome notes

+ +

The buffer property was removed in {{CompatChrome(44.0)}}.

+
+ +

 

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf