node package manager
We need your input. Help make JavaScript better: Take the 2017 JavaScript Ecosystem survey »

songle-widget

Songle Sync API

Songle Syncは音楽に合わせて沢山のスマートフォン・パソコン・IoTデバイスを制御できる大規模音楽連動制御プラットフォームです。Songle Sync APIを使うと、JavaScriptで音楽に連動したイベント駆動のプログラムを容易に記述できます。

サンプルプログラムは以下のページに掲載されています。

APIを使うためにはSongle SyncのWebサイトでユーザ登録を行い、トークンを取得する必要があります。詳細はチュートリアル Step.3を参照してください。

Webプログラミング

Webブラウザ向けには http://api.songle.jp/v2/api.jsscript タグで埋め込むのが一番簡単です。

onSongleWidgetAPIReady(SW) {
  var p = new SW.Player({
    accessToken: 'your access token here'
  , secretToken: 'your secret token here'
  , mediaElement: 'div.widget'
  });
  p.addPlugin(new SW.Plugin.SongleSync());
  p.useMedia('http://youtube.com/watch?v=xOKplMgHxxA');
  // 以降、この動画と連動する演出のプログラム
}

npm install

Songle Sync APIのライブラリは npm コマンドを使ってインストールすることもできます。とくに、Node.jsを実行できるIoTデバイスなどではこちらの方法が必須となります。

npm install songle-widget --save

プログラムは以下のようになります。

  var SW = require('songle-widget');
  var p = new SW.Player({
    accessToken: 'your access token here'
  , secretToken: 'your secret token here'
  // Node.jsはWebブラウザではないので音楽の再生はできない
  //, mediaElement: 'div.widget'
  });
  p.addPlugin(new SW.Plugin.SongleSync());
  p.useMedia('http://youtube.com/watch?v=xOKplMgHxxA');
  // 以降、この動画と連動する演出のプログラム

Songle Sync APIの詳しい使い方

より詳しい使い方や、簡単にSongle Syncを体験できるアプリ例はチュートリアルを参照してください。

その他、以下のページに関連する情報が掲載されています。

  • Songle Widget サンプルプログラム

    • https://github.com/SongleJp/songle-widget
    • Songle Sync APIを使って書かれたプログラムのソースコードを閲覧したり、それをもとに新しいプログラムを作ったりできます。
  • Songle Sync APIドキュメント


Copyright (c) 2017 AIST Songle Project