TextAlive App APIの開発履歴

歌詞が音楽にあわせて動くWebアプリケーション（リリックアプリ）を開発できるAPI「TextAlive App API」の開発履歴を紹介しています。チュートリアルなどは開発者向けWebサイト「TextAlive for Developers」をご覧ください。

v0.3.x (2021/03/XX)

App APIの利用に開発者用Appトークンが必要になります

動作を高速化します

v0.2.2 (2021/01/01)

Songle API の読み込み方法を改良しました (関連: GitHub Issue #5)

getValenceArousal などで感情値（V/A 空間の座標値）を正しく取得できなかった問題を修正しました

アプリ起動時の振る舞いについて Player.app.songUrl のドキュメントに追記しました

内部で利用している TypeScript を 3 から 4 にアップデートしました

v0.2.1 (2020/10/30)

バナー表示を調整しました

PlayerOptions.mediaElement に文字列が指定されたらセレクタとして扱い、DOM要素を検索するようにしました

PlayerListener.onLyricsLoad の第一引数の型を更新して、歌詞発声タイミングのID、訂正IDを取得できるようにしました

v0.2.0 (2020/10/17)

機能追加

音源の音量を Player.volume で調整できるようにしました

createFromSongUrl などによる読み込みプロセスで、歌詞情報が存在していても読み込まないオプション PlayerVideoOptions.video.lyricId = 0 を追加しました (詳細: PartialVideoEntry.lyricId)

PlayerOptions.fontFamilies を指定することでWebフォントを読み込めるようにしました

[{ key: "Droid Sans", en: "Droid Sans", google: true }] のように指定することで Google Fonts を読み込めます

[{ key: "mplus1p", en: "Mplus 1p", url: "https://api.textalive.jp/fonts/mplus1p.css" }] のように指定することで一般的なCSSファイルを読み込み、中で定義された @font-face を利用できるようにします

例えば次のようにします:

code:webfontloader.html

バナーの表示オプション PlayerOptions.mediaBannerPosition を追加しました

バナーにはTextAliveロゴやアーティスト名が表示されます

TextAliveホストが存在する場合は自動的に非表示になります

埋め込みプレイヤーの下 (embed) 以外に、画面の上下左右 (top left など) に固定できます

バグ修正

ITextUnit の利用できないプロパティを削除しました (GitHub Issue #4)

IDataLoader.lyricsId が不正な値になる問題を修正しました

v0.1.2 (2020/9/25)

バグ修正

Webアプリケーションが iframe 内で読み込まれた際に onAppReady イベントが発火しないバグを修正しました

CodePen https://codepen.io/arcatdmz/pen/abNXJgG のようなWebベースの開発環境がこのバグの影響を受けていました

このバグが修正されたため、Webベースの開発環境で手軽に TextAlive App API を試せるようになりました

その他の改善

コンソールにSongle APIの warning が表示されないようにしました

TextAlive Playerクラスに isLoading プロパティが追加されました

createFromSongUrl などによる読み込みプロセスがすでに走っているかどうかを判定できるようになりました

isLoading が true のとき、さらに createFromSongUrl などを呼ぶと、例外を投げるようになりました

例外のvideoプロパティにアクセスすると、読み込み中の動画オブジェクトを返すPromiseを取得できます

英語のREADMEドキュメント README.en.md を追加しました

v0.1.1 (2020/9/18)

TextAlive App API が一般公開されました