よくありそうな質問

よくありそうな質問

指定以外の動画プレイヤーを使いたい

本ギミックはYamaPlayer、iwaSync、VizVidに対応しています。
ただしこれは動画プレイヤーごとに対応作業を行っているため、動画プレイヤーとの連携はこれらに限ります。

そのため指定以外の動画プレイヤーと併用する場合、プレイリストから直接再生・キューへの追加は出来ません。
プレイリストからURLをコピーし、動画プレイヤーにペーストするという作業が必要になります。

それで問題なければ指定された以外のプレイヤーを使うことが出来ます。

ℹ️
v2.0.0以前、使用の有無に関わらずYamaPlayerのインポートが必須でしたが、
v2.0.0以降は使用する動画プレイヤーのみインポートすればOKです。

曲数の上限は?

1000曲程度までを想定しており、仕様上の上限は6600曲です。(想定であり動作保証ではありません)
上限の調査は行っていませんが、少なくとも400曲程度であれば安定して使えることを確認しています。

なお、極端に多い場合単純にサムネイルの読み込みに非常に時間がかかるため、ある程度抑えることをオススメします。

サムネイルを読み込む速度は?

サムネイルは66枚ごとに読み込むようになっており、初回は7秒ほどかかります。
2回目以降はキャッシュから拾うため1秒未満です。

プレイリスト更新後の読み込みもまた7秒ほどかかり、その次の読み込みから1秒未満になります。

※「初回」とはキャッシュがあるかどうかなので、誰かが読み込めば次に読み込む人は速くなります。 ※ Udonの制約で画像の読み込みは5秒ごとにしか行えないため、サムネの取得がすぐに出来ても次の66枚を読み込むのは5秒後になります。

読み込めない曲がある…

スプレッドシート側でURLの入力を間違えているか、シートの式が間違っている可能性があります。
よく分からなければ、作者に問い合わせてください。

D列が非表示になっているので、表示して赤色になっている行が無いか、計算式がおかしくなっていないか見てみることも出来ます。

どの程度使うとYoutubeAPIのレート制限に達する?また、達した場合の動作は?

ざっくり

本ギミックでは動画のタイトル情報の取得にGoogleのYoutubeAPIを使っています。
これは1日あたりに使える回数が決まっていて、制限を超えると情報が取得できなくなります。

この情報取得を実行するタイミングは「任意の誰かがプレイリストを読み込んだら」のため、Visitsが多いワールドで使用すると制限にかかる可能性が高くなります。

一方で、APIレート制限に到達してもタイトル情報以外の機能は動作するように作られているため、APIレート制限に到達しても本ギミックの使用には問題ありません。

具体的には、
APIの制限を超えた状態でプレイリストに追加された動画は、そのタイトル情報を読み込むことができなくなります。
次の日になり制限がリセットされれば問題なくタイトルは読み込まれます。
また、この状態でもタイトル情報が無いだけでサムネイルや動画再生は問題なく行うことができます。

詳細に

ℹ️
  • 以前軽く検証した際、GASから利用するAPI使用量の計算が公式ドキュメント記載のものより緩かったため、この項目の説明は不正確である可能性があります。
  • この項目での説明はドキュメント通りにAPIのレート制限を喰らう前提で記載しています。

ユーザーあたり動画情報の取得APIは1日1万回叩くことができます。

また、動画情報取得のリクエストでは1回あたり50個の動画を要求できます。
ワールドに人が入るたびに動画一覧の要求が行われるため、

  • プレイリストの動画が50個 : 1日1万VisitsでAPI制限に到達
  • プレイリストの動画が500個 : 1日1000VisitsでAPI制限に到達

となります。

ただこれだとワールドによってはかなり早い段階で動画情報が取れなくなるため、APIから取れなかった場合はキャッシュから取得するようにしています。
そのため、APIの使用制限に達しても新しく追加した動画以外は正常に動画タイトルが表示されます。

APIの使用制限に達した状態でプレイリストに動画を追加した場合、追加した動画についてはタイトルがエラーコードになります。
サムネ表示および動画再生については問題ありません。

複数のプレイリストを作りたい

作者サーバーを使って複数種類のプレイリストを作成したい場合、個別に案内しています。
お気軽にお問い合わせください。

利用者自身で設置している場合、複数のディレクトリでセットアップすることで複数のプレイリストが作成可能です。