メインコンテンツまでスキップ

オーディオビジュアライザーの作成

完成されたプロジェクトをフォークして詳細をご確認ください。

アナライザーでサウンドを読み取る方法の詳細については、ユーザーマニュアルのエフェクトと解析を参照してください。

このチュートリアルでは、PlayCanvasを使用して、WebGLのオーディオビジュアライザアプリケーションを作成する方法を説明します。オーディオストリームの余分な周波数データを取得し、PlayCanvasキャンバスにそのデータをレンダリングします。

オーディオビジュアライザは2つのスクリプトで構成されています。アナライザは、オーディオを再生し、アナライザノードを介してデータを抽出します。これは最新のブラウザに組み込まれているWeb Audio APIの一部です。ビジュアライザは、アナライザからデータを取得してグラフとして画面上にそれをレンダリングします。

アナライザー (Analyser)​

import { Script } from 'playcanvas';

export class Analyser extends Script {
static scriptName = "analyser";

/**
* @attribute
* @title Fftsize
* @type {number}
*/
fftsize = null;

// initialize code called once per entity
initialize() {
const context = this.app.systems.sound.context;

// アナライザーノードを作成して設定する
this.analyser = context.createAnalyser();
this.analyser.smoothingTimeConstant = 0.6;
this.analyser.fftSize = this.fftsize;

this.freqData = new Float32Array(this.analyser.frequencyBinCount);
this.timeData = new Float32Array(this.analyser.fftSize);

const slot = this.entity.sound.slot("track");
slot.setExternalNodes(this.analyser);
}

// update code called every frame
update(dt) {
this.analyser.getFloatFrequencyData(this.freqData);
this.analyser.getFloatTimeDomainData(this.timeData);
}
}

ここでコードを詳しく見てみましょう。

まず、contextを取得します。これはAudioContextのアプリケーションインスタンスです。これは、最新ブラウザの標準であるWeb Audio APIに含まれるAnalyserNode を新規で作成するために使用します。AnalyserNodeにより、フレーム毎にオーディオの生のデータに値の配列としてアクセスすることが可能になります。いくつかのsmoothingTimeConstantプロパティにより、データサンプリングが時間と共に平滑化されるかどうかを決定します。0の場合は平滑化されません。1は非常に滑らかになります。fftSizeは、アナライザノードが生成するサンプル数を定義します。これは2の累乗である必要があります。高いく設定するほど綿密になり、CPUに負荷がかかります。

AnalyserNodeからデータには、整数のUint8Arrayまたは浮動小数点数のFloat32Arrayとしてアクセスできます。このデモでは、浮動小数点数を使用しているため、fftSizeの半分の大きさでそれぞれ2つのFloat32Arrayを割り当てる必要があります。

セットアップの最後の部分は、PlayCanvas SoundSlot APIのsetExternalNodesを使用して、この新しいノードをSound Componentのノードチェーンに挿入することです。

次に、私たちの更新ループでは、AnalyserNodeニョードメソッドgetFloatFrequencyDataとgetFloatTimeDomainDataを使用して、配列にデータを記録します。このデータをビジュアライザースクリプトで使用します。

ビジュアライザー​

import { Script, Vec3 } from 'playcanvas';

export class Visualizer extends Script {
static scriptName = "visualizer";

/**
* @attribute
* @title Analyser
* @type {Entity}
*/
analyser = null;

/**
* @attribute
* @title Freqcolor
* @type {Color}
*/
freqcolor = null;

/**
* @attribute
* @title Timecolor
* @type {Color}
*/
timecolor = null;

/**
* @attribute
* @title Height Scale
* @type {number}
*/
heightScale = 1;

// initialize code called once per entity
initialize() {
this.lines = [];
const count = this.analyser.script.analyser.fftsize;
for (let i = 0; i < count; i++) {
this.lines.push(new Vec3(), new Vec3()); // 線分ごとに2つずつ追加する
}

this.xScale = 0.10 * 2048 / count;
this.minDb = this.analyser.script.analyser.analyser.minDecibels;
this.maxDb = this.analyser.script.analyser.analyser.maxDecibels;
this.freqScale = 1 / (this.maxDb - this.minDb);
this.freqOffset = this.minDb;
}

// update code called every frame
update(dt) {
this.renderData(this.analyser.script.analyser.freqData, this.freqcolor, this.freqScale, this.freqOffset);
this.renderData(this.analyser.script.analyser.timeData, this.timecolor, 0.5, 0);
}

renderData(data, color, scale, offset) {
let lineIndex = 0;
for (let i = 0; i < data.length - 1; i++) {
if (lineIndex < this.lines.length - 1) {
const h1 = scale * (data[i] - offset);
const h2 = scale * (data[i + 1] - offset);

this.lines[lineIndex].set(i * this.xScale, this.heightScale * h1, 0);
this.lines[lineIndex + 1].set((i + 1) * this.xScale, this.heightScale * h2, 0);

lineIndex += 2;
}
}
this.app.renderLines(this.lines, color);
}
}

ビジュアライザースクリプトは、すべてのアナライザーからのデータを取得し、this.app.renderLines APIを使用して直線グラフとしてレンダリングします。

設定では、線に使用するベクターを割り当てています。各データの点に対して2つ必要です(線の開始と終了)。その後、すべての線が画面に表示されることを確認するためにいくつかのスケールファクタを設定します。AnalyserNodeにはデータに含むことができるデシベルの最小値と最大値が含まれています。これは必ず正確ではないようですが(この範囲外の値を取得しました)、データを正規化するための良い基礎となります。

renderData関数は、すべてのデータをループして、事前に割り当てられたベクトルの1つを、現在のポイントから始まり、次のポイントで終了するように設定します。

updateループでは、周波数データ (Frequency)および 時間領域 (Time Domain)の両方のグラフを描画します。

その他のアイデアは?​

音楽の視覚化の方法を一部紹介させていただきました。音楽に合わせて3Dバーのスケーリングや色や明るさの調整を行うこともできます。SoundCloudにビジュアライザを繋げてユーザに選択させる方法もあります。可能性はたくさんあります。