TextAlive for Developers
リリックビデオ・リリックアプリ開発のための TextAlive 解説ページ

サンプルコード: textalive-app-dance

リリックビデオ制作支援サービス TextAlive には、リリックビデオの演出用テンプレートをプログラミングしたり、歌詞が音楽にあわせて動くWebアプリケーション(リリックアプリ)を開発したりできる開発者向けの機能が満載です。

このページでは TextAlive の開発者向け機能を解説しています。 TextAlive を使うには https://textalive.jp を、一般的な使い方については TextAlive の使い方 をご覧ください。

初音ミク「マジカルミライ 2024」プログラミング・コンテスト

このページで紹介している TextAlive App API を使ったWebアプリケーションをプログラミングして応募できるコンテストが開催中です!

詳しくは「イベント紹介ページ」をご覧ください。奮ってご応募ください。

TextAlive App API npm version

TextAlive App API は、音楽に合わせてタイミングよく歌詞が動くWebアプリケーション(リリックアプリ)を開発できるJavaScript用のライブラリです。 script タグでWebサイトに読み込んだり、 npm パッケージ textalive-app-api をインストールすることで、楽曲のサビやビートなどの楽曲地図情報を取得したり、歌詞のタイミング情報を取得したりできるようになります。

このAPIを使うと、一曲のために作り込んだ演出はもちろんのこと、TextAliveに登録されているさまざまな楽曲に合わせて動作する演出をプログラミングできます。また、Songle Syncを使って周りの人と同期した演出をプログラミングすることも可能です。 さらに、このAPIを使って開発されたWebアプリケーションは、所定の登録プロセスを経ることで、 TextAlive 本サイト上で「スタイル」として選択可能になる予定です。

ぜひ、TextAlive App APIを活用して音楽と歌詞の魅力を引き出す多様なアプリケーションを開発してみてください。なお、 API の呼び出しには「開発者登録」 で入手できるアプリトークンが必要となります。 APIの更新履歴は TextAlive App APIの開発履歴 のページをご覧ください。

TextAlive App APIについて技術的に分からないことやバグ報告などがあれば、GitHub IssuesまたはGitter Chatまでお願いいたします。

HTML
<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
<script src="https://unpkg.com/textalive-app-api/dist/index.js"></script>
<script>
const { Player } = TextAliveApp;
</script>
コマンドライン
npm install textalive-app-api
import { Player } from "textalive-app-api";

その他のAPI

Template API

TextAlive では、「テンプレート」と呼ばれる歌詞やグラフィックの演出プログラムをWebサイト上の開発環境内で JavaScript により記述して、他の人に使ってもらうことができます。

テンプレートのプログラミングで利用できるイージング関数や音楽地図情報の探索のための関数は App API にも用意されており、片方を学習したらもう片方の学習コストは低く抑えられます。

Template API と App API の違いについては比較記事をご覧ください。

Embed API

TextAlive 上で制作された動画コンテンツを他のWebサイトに埋め込むには TextAlive Embed API が便利です。

下のコードスニペットの {videoId} を埋め込みたい動画IDに置き換えてご利用ください。

<iframe src="https://embed.textalive.jp/?id={videoId}" />
TextAlive App API は、能動的音楽鑑賞サービス Songle の音楽理解技術と開発者向けに公開されている Songle API を利用しています。詳しくは以下の外部サイトをご覧ください。

更新履歴

新たに「時区間駆動型API (time-range-driven API)」をサポートしたTextAlive App API v0.4.0 を公開しました
2024/05/12
初音ミク「マジカルミライ」 10th Anniversary プログラミング・コンテスト イベント紹介ページを更新し、オープンソース公開された応募作一覧や当時の模様を追加しました
2023/03/30
初音ミク「マジカルミライ 2021」プログラミング・コンテスト イベント紹介ページにオープンソース公開された応募作一覧を追加しました
2021/12/03
初音ミク「マジカルミライ 2020」プログラミング・コンテスト イベント紹介ページにオープンソース公開された応募作一覧を追加しました
2020/12/18
TextAlive App API v0.2.1 を公開しました
2020/10/30
TextAlive App API v0.2.0 を公開しました
2020/10/17
サンプルコードを追加し、一部を CodePen に掲載しました
2020/09/27
TextAlive App API v0.1.2 を公開しました
2020/09/25
TextAlive App API v0.1.1 を公開し、 Webサイト「TextAlive for Developers」を開設しました
2020/09/18

API の開発履歴へ

TextAlive について

TextAliveは、産業技術総合研究所メディアインタラクション研究グループが研究開発しています。学術研究目的で公開しながら実証実験中です。本研究の一部は、JST CREST (JPMJCR20D4; RecMusプロジェクト) の支援を受けています。

本研究はWeb上にコンテンツを公開されている多くの方々によってはじめて可能になったプロジェクトであり、Webを前提としたコンテンツ制作の可能性を追求しています。

TextAlive