スーパーLIVE開催情報をCinderella APIに追加しました

2022-05-14

先日、ミュージックJAMのスーパーLIVEの開催通知アプリである JAM Alert をリリースしました。この JAM Alert は Windows でしか利用できませんが、個人で利用している通知アプリやプロダクション等の Discord bot でもこれと同等の情報を取り扱うことができるよう、Cinderella API でも同等の情報を出力します。

なるべく多くのプロデューサーのスーパーLIVEに対するアクセスを改善し、ミュージックJAMをより快適に遊ぶことができるよう、引き続き改良していきます。

追加されたAPI

#API 名称API Endpoint
1ミュージックJAM スーパーLIVE情報 分析結果/v2/events/jam/analyze/[eventInfoId]
2ミュージックJAM スーパーLIVE情報 観測履歴/v2/events/jam/progress/[eventInfoId]

API説明

ミュージックJAM スーパーLIVE情報 分析結果

JAM Alert で出力される内容と同等の情報を出力します。

superLiveNumber はボーダーbotが採番している番号です。スーパーLIVEまでの一連のサイクル(ゲージ0%~100%になってスーパーLIVE開催)までの間、一意の番号を取ります。スーパーLIVEが終了すると、新しい番号が採番されます。「95%以上になったら通知をしたい」というようなケースでは、この番号を考慮に入れてください。

もし単にスーパーライブ開催中のみを観測したい場合は、isUnderSuperLive = true のみを考慮すればよいと思います。

ミュージックJAM スーパーLIVE情報 観測履歴

スーパーLIVEのゲージ(%)の観測記録です。

ボーダーbotが出力している分析結果に頼らず、次のスーパーLIVEまでの時間を計算するような場合に利用してください。スーパーLIVE間の間隔を調査するような用途でも利用できると思います。

なお、ボーダーbotは5秒より短い間隔で観測することはありません。