プログラミング・コンテストについて

TextAlive App API は音楽に合わせてタイミングよく歌詞が動くWebアプリケーション（リリックアプリ）を開発できるJavaScript用のライブラリです。初音ミク「マジカルミライ 2024」では、このAPIを使って、マジカルミライ 楽曲コンテストの受賞作品6曲にあわせて魅力的に動くリリックアプリをプログラミングするコンテストが開催されます。

このプログラミング・コンテストは、今年で5度目の開催となります。2020年、2021年、2022年、そして昨年のサポートページや入選作品、サンプルコードを、ぜひご覧ください。

プログラミング・コンテストの参加方法

応募方法や応募のきまり、リリックアプリの作り方の概要は、YouTube動画「TextAlive App API講座」をご覧ください。

このページ下部の「作品応募に向けて」もぜひ参考にしてみてください。

TextAlive App API でできること

TextAlive App API を使うと、Web上で公開されている楽曲と歌詞を利用して、タイミングよく歌詞が動くWebアプリケーションを開発できます。楽曲と歌詞はいずれもURLが TextAlive サービスサイトに登録されている必要がありますが、コンテスト参加者のみなさまは心配ご無用です。

コンテストの対象となる課題曲は 6 曲とも TextAlive への登録が済んでおり、API上で楽曲のURL（ピアプロまたはYouTubeのURLです）を指定すれば、それと紐づいた歌詞（いずれもピアプロのURLです）が自動的に読み込まれるので、すぐに演出をプログラミングできます。

APIを使うと、例えば次のようなリリックアプリが作れます。

次の作例では、HTML/CSS/JSのリンクをクリックするとソースコードを見ることができます。「EDIT ON CODEPEN」をクリックすると、ソースコードを編集できます。（スマートフォンでは動作しないので、パソコンで試してみてください。） もっと作例を見たいときは「サンプルコード」をご覧ください。

TextAlive App API の使い方

TextAlive App API は script タグでWebサイトに読み込んだり、 npm パッケージ textalive-app-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";

作品応募に向けて

プログラミング・コンテストはクリプトン・フューチャー・メディア株式会社が主催し、産業技術総合研究所（産総研） RecMusプロジェクトが協力しています。基本的な情報やお問い合わせ先は 公式サイト をご覧ください。ここでは、作品応募に向けて、技術面でのポイントをご紹介します。

GitHub プライベートリポジトリ

プログラミング・コンテストへ作品を応募するには、作品のソースコードをソーシャルコーディングプラットフォーム「 GitHub」上にアップロードする必要があります。また、主催者による審査が終わるまで他の人に作品のソースコードが見られないようにするため、「プライベートリポジトリ」を作成する必要があります。

詳しい方法は Web 検索 で見つかるチュートリアルを参考にしてみてください。

Webアプリケーション

主催者による審査は、 GitHubからダウンロードしたソースコードを実際のWebアプリケーションとして動作させて行われます。また、入選作品は主催者のWebサーバなどに配置され、一般に公開されてユーザ投票が行われ、入賞を競うことになります。

こうしたことから、今回、応募作品はHTTPサーバ上に設置するだけで動作する静的アプリケーションに限られています。

しかしながら、一般的なWebブラウザで動作するものであればよいので、さまざまなライブラリと組み合わせて開発して構いません。例えば、three.js、PixiJS、p5jsのように、映像演出に便利なライブラリは凝ったことをしようとすればほとんど必須かもしれません。

ネットワーク接続を前提としてよいので、Web APIの類を活用してもよいでしょう。Web標準に則ってデバイスのハードウェアを活用するAPIを使っても面白いかもしれません。

READMEファイル

応募フォームに記入できるアピールはプレーンテキストのみで情報量が限られていますが、リポジトリに配置できるREADMEは自由に編集可能で、画像ファイルを貼り込んだりすることもできます。

サンプルコードのREADME のようにWebアプリケーションのビルド、実行手順を書くことはもちろん必要ですが、開発した作品の魅力をアピールできるチャンスとしても、ぜひ活用してください。

デモアプリの設置・動画の撮影と編集

審査に際しては極力READMEファイルなどを見ながらWebアプリケーションを応募者の意図通り動作させようと試みますが、それでも応募者の環境で動いていたものが動かなくなってしまうことはありえます。

そのような場合の保険として、また、作品のアピールのため、応募時にはWebアプリケーションを設置したサイトのURLとデモ動画のURLを入力することをおすすめします。 動画撮影には、macOSの標準機能やWindowsの標準機能が使えます。詳しくは Webで検索 してみてください。

なお、審査自体は原則として作品そのものを対象として行われるため、デモアプリやデモ動画のURL入力は必須ではありませんのでご注意ください。

楽曲の読み込みとバージョン固定

審査対象の楽曲は、Webアプリケーションの中で以下のように読み込むことができます。楽曲URLとして、 https://piapro.jp/t/曲ID のような短いものではなく、最後の数字まで含めた https://piapro.jp/t/曲ID/数字 の形式でないと正しく読み込めないことにご注意ください。また、歌詞タイミングやサビのタイミング（音楽地図）が固定されるようにバージョン番号を指定しておいてください。

バージョン番号を使った音楽地図の固定について詳しくは チュートリアル「楽曲情報の活用」ページのTips をご覧ください。

player.addListener({
  onAppReady: (app) => {
    if (!app.managed) {
      // SUPERHERO / めろくる
      player.createFromSongUrl("https://piapro.jp/t/hZ35/20240130103028", {
        video: {
          // 音楽地図訂正履歴
           beatId: 4592293,
           chordId: 2727635,
           repetitiveSegmentId: 2824326,
           // 歌詞タイミング訂正履歴: https://textalive.jp/lyrics/piapro.jp%2Ft%2FhZ35%2F20240130103028
           lyricId: 59415,
           lyricDiffId: 13962
         },
       });

      // いつか君と話したミライは / タケノコ少年
      // player.createFromSongUrl("https://piapro.jp/t/--OD/20240202150903", {
      //   video: {
      //     // 音楽地図訂正履歴
      //      beatId: 4592296,
      //      chordId: 2727636,
      //      repetitiveSegmentId: 2824327,
      //      // 歌詞タイミング訂正履歴: https://textalive.jp/lyrics/piapro.jp%2Ft%2F--OD%2F20240202150903
      //      lyricId: 59416,
      //      lyricDiffId: 13963
      //    },
      //  });

      // フューチャーノーツ / shikisai
      // player.createFromSongUrl("https://piapro.jp/t/XiaI/20240201203346", {
      //   video: {
      //     // 音楽地図訂正履歴
      //      beatId: 4592297,
      //      chordId: 2727637,
      //      repetitiveSegmentId: 2824328,
      //      // 歌詞タイミング訂正履歴: https://textalive.jp/lyrics/piapro.jp%2Ft%2FXiaI%2F20240201203346
      //      lyricId: 59417,
      //      lyricDiffId: 13964
      //    },
      //  });

      // 未来交響曲 / ヤマギシコージ
      // player.createFromSongUrl("https://piapro.jp/t/Rejk/20240202164429", {
      //   video: {
      //     // 音楽地図訂正履歴
      //      beatId: 4592298,
      //      chordId: 2727638,
      //      repetitiveSegmentId: 2824329,
      //      // 歌詞タイミング訂正履歴: https://textalive.jp/lyrics/piapro.jp%2Ft%2FRejk%2F20240202164429
      //      lyricId: 59418,
      //      lyricDiffId: 13965
      //    },
      //  });

      // リアリティ / 歩く人
      // player.createFromSongUrl("https://piapro.jp/t/ELIC/20240130010349", {
      //   video: {
      //     // 音楽地図訂正履歴
      //      beatId: 4592299,
      //      chordId: 2727639,
      //      repetitiveSegmentId: 2824330,
      //      // 歌詞タイミング訂正履歴: https://textalive.jp/lyrics/piapro.jp%2Ft%2FELIC%2F20240130010349
      //      lyricId: 59419,
      //      lyricDiffId: 13966
      //    },
      //  });

      // The Marks / 2ouDNS
      // player.createFromSongUrl("https://piapro.jp/t/xEA7/20240202002556", {
      //   video: {
      //     // 音楽地図訂正履歴
      //      beatId: 4592300,
      //      chordId: 2727640,
      //      repetitiveSegmentId: 2824331,
      //      // 歌詞タイミング訂正履歴: https://textalive.jp/lyrics/piapro.jp%2Ft%2FxEA7%2F20240202002556
      //      lyricId: 59420,
      //      lyricDiffId: 13967
      //    },
      //  });
    }
  }
});