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

JavaScript API

JavaScript API

Songle Widget を JavaScript から操作するための API リファレンスです。

window​

onSongleWidgetCreate​

Songle Widget の DOM Element が作成されたタイミングで実行されます(このメソッドは、事前に定義しておく必要があります)。

ステータス説明
-このステータスは、将来のために予約されています。
window.onSongleWidgetCreate =
function(apiKey, songleWidget)
{
console.log("status: " + songleWidget.status);
}

onSongleWidgetError​

Songle Widget の初期化が失敗したタイミングで実行されます(このメソッドは、事前に定義しておく必要があります)。

ステータス説明
100配信元の楽曲は、削除されているため埋め込むことができませんでした。
101配信元の楽曲は、許可されてないため埋め込むことができませんでした。
200音楽地図のダウンロードが中断しました。
201音楽地図のダウンロードが失敗しました。
300配信元の音源(mp3)のダウンロードに失敗しました。
window.onSongleWidgetError =
function(apiKey, songleWidget)
{
console.log("status: " + songleWidget.status);
}

onSongleWidgetReady​

Songle Widget の初期化が成功したタイミングで実行されます(このメソッドは、事前に定義しておく必要があります)。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
console.log("Hello,Songle Widget!!");
}

onSongleWidgetReload​

TBD

window.onSongleWidgetReload =
function(apiKey, songleWidget)
{
console.log("Songle Widget was reloaded!!");
}

onSongleWidgetRemove​

TBD

window.onSongleWidgetRemove =
function(apiKey, songleWidget)
{
console.log("Songle Widget was removed!!");
}

SongleWidget​

dataset.api​

埋め込みオプションに与えられた data-api の値を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
console.log(songleWidget.dataset.api);
}

dataset.url​

埋め込みオプションに与えられた data-url の値を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
console.log(songleWidget.dataset.url);
}

mode​

起動モードを返します。

起動モード説明
SongleWidgetAPI.MP3_MODE音楽プレーヤモード
SongleWidgetAPI.NN_VIDEO_MODE動画プレーヤモード(ニコニコ動画)
SongleWidgetAPI.YT_VIDEO_MODE動画プレーヤモード(YouTube)
window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
switch(songleWidget.mode)
{
case SongleWidgetAPI.MP3_MODE:
console.log("Songle Widget is mp3 mode.");
break;

case SongleWidgetAPI.NN_VIDEO_MODE:
console.log("Songle Widget is nn video mode.");
break;

case SongleWidgetAPI.YT_VIDEO_MODE:
console.log("Songle Widget is yt video mode.");
break;
}
}

uuid​

UUID を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
console.log(songleWidget.uuid);
}

videoID​

動画 ID を返します(ニコニコ動画 / YouTube のみ)。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
console.log(songleWidget.videoID);
}

rootElement​

TBD

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
console.log(songleWidget.rootElement);
}

isPlaying​

ステータスが playing の場合 true を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
if(songleWidget.isPlaying)
console.log("Songle Widget is playing now.");
}
, 1000);
}

isPaused​

ステータスが paused の場合 true を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
if(songleWidget.isPaused)
console.log("Songle Widget is paused now.");
}
, 1000);
}

isStopped​

ステータスが stopped の場合 true を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
if(songleWidget.isStopped)
console.log("Songle Widget is stopped now.");
}
, 1000);
}

isSeeking​

ステータスが seeking の場合 true を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
if(songleWidget.isSeeking)
console.log("Songle Widget is seeking now.");
}
, 1000);
}

bpm​

現在の bpm を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.bpm + " [bpm]");
}
, 1000);
}

currentBeat​

現在の拍を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.currentBeat);
}
, 1000);
}

currentChord​

現在の和音を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.currentChord);
}
, 1000);
}

currentNote​

現在のメロディを返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.currentNote);
}
, 1000);
}

currentChorusSegment​

現在のサビ(橙色の繰り返し)区間情報を返します。エイリアスとして currentChorus でも参照できます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.currentChorusSegment);
}
, 1000);
}

currentRepeatSegment​

現在のサビ(橙色の繰り返し・青色の繰り返し)区間情報を返します。エイリアスとして currentRepeat でも参照できます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.currentRepeatSegment);
}
, 1000);
}

isPlayingChorusSegment​

(橙色の繰り返し)区間を再生中の場合 true を返します。エイリアスとして isPlayingChorus でも参照できます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.isPlayingChorusSegment);
}
, 1000);
}

isPlayingRepeatSegment​

(橙色の繰り返し・青色の繰り返し)区間を再生中の場合 true を返します。エイリアスとして isPlayingRepeat でも参照できます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.isPlayingRepeatSegment);
}
, 1000);
}

duration​

楽曲の再生時間を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.duration.milliseconds + " [ms]");
console.log(songleWidget.duration.seconds + " [sec]");
console.log(songleWidget.duration.minutes + " [min]");
}
, 1000);
}

position​

楽曲の再生位置を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.position.milliseconds + " [ms]");
console.log(songleWidget.position.seconds + " [sec]");
console.log(songleWidget.position.minutes + " [min]");
}
, 1000);
}

loadedRatio​

楽曲のロードされた割合を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.loadedRatio * 100 + " [%]");
}
, 1000);
}

playedRatio​

楽曲のプレイされた割合を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
setInterval(
function()
{
console.log(songleWidget.playedRatio * 100 + " [%]");
}
, 1000);
}

volume​

音量を操作します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.volume = SongleWidgetAPI.MIN_VOLUME; // Min volume.

songleWidget.volume = SongleWidgetAPI.MAX_VOLUME; // Max volume.
}

song​

楽曲情報(タイトルなど)及び、を返します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
/*
[...].song.url

[...].song.id
[...].song.title
[...].song.permalink
[...].song.duration
[...].song.position
[...].song.rmsAmplitude

[...].song.artist.id
[...].song.artist.name

[...].song.scene.beats
[...].song.scene.beats[ beatIndex ].index
[...].song.scene.beats[ beatIndex ].start
[...].song.scene.beats[ beatIndex ].position

[...].song.scene.chords
[...].song.scene.chords[ chordIndex ].index
[...].song.scene.chords[ chordIndex ].start
[...].song.scene.chords[ chordIndex ].duration
[...].song.scene.chords[ chordIndex ].name

[...].song.scene.notes
[...].song.scene.notes[ noteIndex ].index
[...].song.scene.notes[ noteIndex ].start
[...].song.scene.notes[ noteIndex ].duration
[...].song.scene.notes[ noteIndex ].pitch
[...].song.scene.notes[ noteIndex ].number

[...].song.scene.chorusSegments
[...].song.scene.chorusSegments[ chorusSegmentIndex ].index
[...].song.scene.chorusSegments[ chorusSegmentIndex ].duration
[...].song.scene.chorusSegments[ chorusSegmentIndex ].repeats
[...].song.scene.chorusSegments[ chorusSegmentIndex ].repeats[ repeatIndex ].index
[...].song.scene.chorusSegments[ chorusSegmentIndex ].repeats[ repeatIndex ].start
[...].song.scene.chorusSegments[ chorusSegmentIndex ].repeats[ repeatIndex ].duration

[...].song.scene.repeatSegments
[...].song.scene.repeatSegments[ repeatSegmentIndex ].index
[...].song.scene.repeatSegments[ repeatSegmentIndex ].duration
[...].song.scene.repeatSegments[ repeatSegmentIndex ].repeats
[...].song.scene.repeatSegments[ repeatSegmentIndex ].repeats[ repeatIndex ].index
[...].song.scene.repeatSegments[ repeatSegmentIndex ].repeats[ repeatIndex ].start
[...].song.scene.repeatSegments[ repeatSegmentIndex ].repeats[ repeatIndex ].duration
*/
console.log(songleWidget.song);
}

eventPollingInterval​

拍の間隔などが極端に短い楽曲は、イベント検出が遅延することがあります。イベント検出は、ポーリングモデルにより実装されてため、タイミングにより次の検出タイミングまで遅延します。この値を小さくすることで、この問題を回避することができます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.eventPollingInterval = 1; // 1 [ms]
}

beatEventPriority​

拍に関するイベント検出の優先度(デフォルト3)を設定します。優先度は、大きいほど優先的に処理されます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.beatEventPriority = 3;
}

beatEventTimingOffset​

拍に関するイベントの実行タイミングのオフセットを設定します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.beatEventTimingOffset = -100; // -100 [ms]
}

chordEventPriority​

和音に関するイベント検出の優先度(デフォルト2)を設定します。優先度は、大きいほど優先的に処理されます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.chordEventPriority = 2;
}

chordEventTimingOffset​

和音に関するイベントの実行タイミングのオフセットを設定します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.chordEventTimingOffset = -100; // -100 [ms]
}

noteEventPriority​

メロディに関するイベント検出の優先度(デフォルト1)を設定します。優先度は、大きいほど優先的に処理されます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.noteEventPriority = 1;
}

noteEventTimingOffset​

メロディに関するイベントの実行タイミングのオフセットを設定します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.noteEventTimingOffset = -100; // -100 [ms]
}

chorusSegmentEventPriority​

サビ(橙色の繰り返し)区間に関するイベント検出の優先度(デフォルト5)を設定します。優先度は、大きいほど優先的に処理されます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.chorusSegmentEventPriority = 5;
}

chorusSegmentEventTimingOffset​

サビ(橙色の繰り返し)区間に関するイベントの実行タイミングのオフセットを設定します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.chorusSegmentEventTimingOffset = -100; // -100 [ms]
}

repeatSegmentEventPriority​

サビ(青色の繰り返し)区間に関するイベント検出の優先度(デフォルト4)を設定します。優先度は、大きいほど優先的に処理されます。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.repeatSegmentEventPriority = 4;
}

repeatSegmentEventTimingOffset​

サビ(青色の繰り返し)区間に関するイベントの実行タイミングのオフセットを設定します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.repeatSegmentEventTimingOffset = -100; // -100 [ms]
}

on​

任意のイベントに対してイベントリスナーを登録します。

イベント別名説明
beatEnterbeatPlayの開始イベントが発生した。
beatLeave-の終了イベントが発生した。
chordEnterchordPlayの開始イベントが発生した。
chordLeave-の終了イベントが発生した。
noteEnternotePlayの開始イベントが発生した。
noteLeave-の終了イベントが発生した。
chorusSegmentEnterchorusEnter(橙色の繰り返し)区間の開始イベントが発生した。
chorusSegmentLeavechorusLeave(橙色の繰り返し)区間の終了イベントが発生した。
repeatSegmentEnterrepeatEnter(橙色の繰り返し・青色の繰り返し)区間の開始イベントが発生した。
repeatSegmentLeaverepeatLeave(橙色の繰り返し・青色の繰り返し)区間の終了イベントが発生した。
reload-Songle Widget()が更新された。
remove-Songle Widget()が削除された。
play-再生した。
pause-一時停止した。
stop-停止した。
seek-シークした。
loadingProgress-楽曲のロードされた割合に変化があった。
playingProgress-楽曲のプレイされた割合に変化があった。
finish-最後まで再生した。
window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.on("beatPlay",
function(e)
{
/*
[...].beat.prev.index
[...].beat.prev.start
[...].beat.prev.position

[...].beat.index
[...].beat.start
[...].beat.position

[...].beat.next.index
[...].beat.next.start
[...].beat.next.position
*/
console.log(e);
});

songleWidget.on("chordPlay",
function(e)
{
/*
[...].chord.prev.index
[...].chord.prev.start
[...].chord.prev.duration
[...].chord.prev.name

[...].chord.index
[...].chord.start
[...].chord.duration
[...].chord.name

[...].chord.next.index
[...].chord.next.start
[...].chord.next.duration
[...].chord.next.name
*/
console.log(e);
});

songleWidget.on("notePlay",
function(e)
{
/*
[...].note.prev.index
[...].note.prev.start
[...].note.prev.duration
[...].note.prev.pitch
[...].note.prev.number

[...].note.index
[...].note.start
[...].note.duration
[...].note.pitch
[...].note.number

[...].note.next.index
[...].note.next.start
[...].note.next.duration
[...].note.next.pitch
[...].note.next.number
*/
console.log(e);
});

songleWidget.on("chorusEnter",
function(e)
{
/*
[...].repeat.index
[...].repeat.start
[...].repeat.duration

[...].segment.index
[...].segment.duration
*/
console.log(e);
});

songleWidget.on("repeatEnter",
function(e)
{
/*
[...].repeat.index
[...].repeat.start
[...].repeat.duration

[...].segment.index
[...].segment.duration
*/
console.log(e);
});
}

off​

任意のイベントに対してイベントリスナーを削除します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.off("beatPlay");

songleWidget.off("chordPlay");

songleWidget.off("notePlay");

songleWidget.off("chorusEnter");

songleWidget.off("repeatEnter");
}

play​

再生します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.play();
}

pause​

一時停止します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.pause();
}

stop​

停止します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.stop();
}

seekTo​

指定の再生位置(ミリ秒)にシークします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.seekTo(SongleWidgetAPI.secondsToMilliseconds(30)); // Seek to 30 seconds.
}

seekToPrevChorus​

現在の再生位置より 1 つ前の(橙色の繰り返し)区間の先頭にシークします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.seekToPrevChorus();
}

seekToNextChorus​

現在の再生位置より 1 つ先の(橙色の繰り返し)区間の先頭にシークします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.seekToNextChorus();
}

seekToPrevRepeat​

現在の再生位置より 1 つ前の(橙色の繰り返し・青色の繰り返し)区間の先頭にシークします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.seekToPrevRepeat();
}

seekToNextRepeat​

現在の再生位置より 1 つ先の(橙色の繰り返し・青色の繰り返し)区間の先頭にシークします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.seekToNextRepeat();
}

setAllEventTimingOffset​

全イベントの実行タイミングのオフセットを設定します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.setAllEventTimingOffset(-100); // -100 [ms]
}

serialize​

音楽地図をシリアライズします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.serialize();
}

remove​

確保されたリソースを解放します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.remove();
}

SongleWidgetAPI​

DEFAULT_SONGLE_WIDGET_SIZE_W​

TBD

DEFAULT_SONGLE_WIDGET_SIZE_H​

TBD

DEFAULT_VIDEO_PLAYER_SIZE_W​

TBD

DEFAULT_VIDEO_PLAYER_SIZE_H​

TBD

MIN_SONGLE_WIDGET_SIZE_W​

TBD

MIN_SONGLE_WIDGET_SIZE_H​

TBD

MIN_VIDEO_PLAYER_SIZE_W​

TBD

MIN_VIDEO_PLAYER_SIZE_H​

TBD

MIN_VOLUME​

TBD

MAX_VOLUME​

TBD

MP3_MODE​

TBD

NN_VIDEO_MODE​

TBD

YT_VIDEO_MODE​

TBD

SOURCE_SONGLE_WIDGET​

TBD

SOURCE_MP3​

TBD

SOURCE_NN_VIDEO​

TBD

SOURCE_YT_VIDEO​

TBD

computeAverageVolume​

平均音量を計算します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
songleWidget.volume = SongleWidgetAPI.computeAverageVolume(songleWidget);
}

computeOffsetFromRepeatSegmentBy​

指定の繰り返し区間に入るの指定拍数前の時間(オフセット)を計算します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var offset =
SongleWidgetAPI.computeOffsetFromRepeatSegmentBy(songleWidget, {
beatCount: 4,
repeatSegmentIndex: 0
}); // e.g. 1600 [ms]

songleWidget.on("chorusEnter",
function()
{
}, { offset: offset });
}

createSongleWidgetElement​

埋め込みコードを生成します。

window.onload =
function()
{
document.body.appendChild(
SongleWidgetAPI.createSongleWidgetElement({
api: "songle-widget-api-example",
url: "www.youtube.com/watch?v=PqJNc9KVIZE",
songAutoPlay: false,
songAutoLoop: false,
onCreate:
function(songleWidget)
{
console.log("status: " + songleWidget.status);
},
onError:
function(songleWidget)
{
console.log("status: " + songleWidget.status);
},
onReady:
function(songleWidget)
{
console.log("Hello,Songle Widget!!");
}
}));
}

findSongleWidgets​

ページ内の制御可能な Songle Widget を検索します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var songleWidgets = SongleWidgetAPI.findSongleWidgets();
songleWidgets[ 0 ].play(); // Start playing song.
}

findSongleWidgetsByAPI​

ページ内の制御可能な Songle Widget を dataset.api から検索します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var songleWidgets = SongleWidgetAPI.findSongleWidgetsByAPI(songleWidget.dataset.api);
songleWidgets[ 0 ].play(); // Start playing song.
}

findSongleWidgetsByURL​

ページ内の制御可能な Songle Widget を dataset.url から検索します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var songleWidgets = SongleWidgetAPI.findSongleWidgetsByURL(songleWidget.dataset.url);
songleWidgets[ 0 ].play(); // Start playing song.
}

findSongleWidgetsByMode​

ページ内の制御可能な Songle Widget を mode から検索します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var songleWidgets = SongleWidgetAPI.findSongleWidgetsByMode(songleWidget.mode);
songleWidgets[ 0 ].play(); // Start playing song.
}

findSongleWidgetsByUUID​

ページ内の制御可能な Songle Widget を uuid から検索します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var songleWidgets = SongleWidgetAPI.findSongleWidgetsByUUID(songleWidget.uuid);
songleWidgets[ 0 ].play(); // Start playing song.
}

findSongleWidgetsByVideoID​

ページ内の制御可能な Songle Widget を videoID から検索します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var songleWidgets = SongleWidgetAPI.findSongleWidgetsByVideoID(songleWidget.videoID);
songleWidgets[ 0 ].play(); // Start playing song.
}

findPrevRepeatSegmentRepeatBy​

指定時刻より前に対して、指定範囲の最も近い繰り返し区間を探します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var chorusSegmentRepeat
= SongleWidgetAPI.findPrevRepeatSegmentRepeatBy(songleWidget, {
position: songleWidget.position.milliseconds,
repeatSegmentIndexA: 0,
repeatSegmentIndexB: 0
});

if(chorusSegmentRepeat)
songleWidget.seekTo(chorusSegmentRepeat.start); // Seek to prev chorus segment.
}

findNextRepeatSegmentRepeatBy​

指定時刻より後に対して、指定範囲の最も近い繰り返し区間を探します。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
var chorusSegmentRepeat
= SongleWidgetAPI.findNextRepeatSegmentRepeatBy(songleWidget, {
position: songleWidget.position.milliseconds,
repeatSegmentIndexA: 0,
repeatSegmentIndexB: 0
});

if(chorusSegmentRepeat)
songleWidget.seekTo(chorusSegmentRepeat.start); // Seek to next chorus segment.
}

mergeRepeatSegments​

指定範囲の繰り返し区間をマージします。

window.onSongleWidgetReady =
function(apiKey, songleWidget)
{
SongleWidgetAPI.mergeRepeatSegments(songleWidget, {
repeatSegmentIndexA: 0,
repeatSegmentIndexB: 5
}); // [ repeat, repeat, repeat, ... ]
}

millisecondsToSeconds​

ミリ秒から秒に変換します。

console.log(SongleWidgetAPI.millisecondsToSeconds(60000));

millisecondsToMinutes​

ミリ秒から分に変換します。

console.log(SongleWidgetAPI.millisecondsToMinutes(60000));

secondsToMilliseconds​

秒からミリ秒に変換します。

console.log(SongleWidgetAPI.secondsToMilliseconds(1.0));

minutesToMilliseconds​

分からミリ秒に変換します。

console.log(SongleWidgetAPI.minutesToMilliseconds(1.0));

version​

バージョン情報を返します。

console.log(SongleWidgetAPI.version);