Spoon Live Desk の使い方
Spoon Live Desk は、Spoon配信者(DJ)が自分の配信をひと目で確認するためのダッシュボードです。配信中のチャット・ギフト・ハート・リスナーをリアルタイムで見られ、配信が終わったあとも履歴を見返せます。
Spoon Live Deskとは
- 配信の状態:配信中かどうか、タイトル、リスナー数、配信時間を表示します。
- リアルタイム表示:チャット、ギフト、現在のリスナー、リスナーの入室・退出を表示します。
- 自動メッセージ:ハートをもらったとき、リスナーが入室したときに、ボットが自動でコメントします。
- 配信履歴:配信ごとに、チャット・リスナー・ギフト・ハートを保存し、あとから検索やCSV保存ができます。
- ブラウザーを閉じても動く:設定で自動接続をオンにすると、配信開始を検知して記録を続けます。
はじめかた
1. ログインして権限に同意する
- ダッシュボードを開き、「Spoonでログイン」を押します。
- Spoonの同意画面で、あなたのSpoonアカウントでログインし、表示される権限を確認して同意します。
- ダッシュボードに戻ると、「Spoon連携中」と表示されます。
同意する権限と、使いみちは次のとおりです。パスワードをこのサービスが受け取ることはありません。
| 配信状態の取得 | 配信中か、タイトル、リスナー数を表示するため。 |
|---|---|
| チャット・ハート・ギフトの受信 | リアルタイム表示と履歴保存のため。 |
| 入室の受信、リスナー一覧の取得 | リスナーの入室・退出の表示と記録のため。 |
| チャットの送信 | ボットが自動メッセージを投稿するため。 |
| DJのフォロー | ボットがあなたをファンとしてフォローするため。 |
2. ボットをブロックしない
ボットがあなたの配信に入室するには、ボットアカウントをブロックしていない必要があります。ブロックしていると、ダッシュボードに「DJがボットをブロックしているため配信に入室できません」と表示されます。ブロックを解除してから、もう一度接続してください。
3. (おすすめ)ボットを固定マネージャーにする
ボットが固定マネージャーだと、リスナーの入室通知を確実に受け取れます。固定マネージャーの指定は、Spoonアプリでご自身が行います(Spoon Live Deskからは指定できません)。配信を終えたあとに、Spoonアプリでボットアカウントを固定マネージャーに指定してください。
4. 配信に接続する
- ダッシュボードを開いたまま配信を始めた場合:配信中を検知すると、自動で接続します。
- 手動で接続する場合:「配信を接続」を押します。確認画面が出ます。
- ブラウザーを閉じていても記録したい場合:「設定」で自動接続をオンにします。
ダッシュボードの見かた
| LIVE NOW / OFF AIR | 配信中かどうか。配信中は、タイトルと開始時刻も表示します。 |
|---|---|
| 現在のリスナー | いま配信を聴いている人数。30秒ごとに更新します。 |
| 配信時間 | 配信を始めてからの経過時間。1秒ごとに進みます。 |
| ライブチャット | リスナーのコメントを新しい順に表示します。「配信を接続」「配信を切断」のボタンもここにあります。 |
| ギフト | 受け取ったギフトの一覧。 |
| 現在のリスナー(一覧) | いま配信にいるリスナーの一覧。 |
| リスナー参加・退出 | 入室と退出の時刻のログ。 |
| 配信履歴 | 過去の配信の一覧。「詳細を見る」で詳細ページを開きます。 |
「配信を切断」を押した配信では、その配信が終わるまで自動では再接続しません。もう一度つなぐときは「配信を接続」を押してください。
設定
画面右上の「設定」から開きます。変更したら、最後に「保存」を押してください。
ハート受信コメント
ハートを受け取ったときに、ボットが自動でコメントします。
| 自動返信を有効にする | オフにすると、ハートを受け取っても返信しません。 |
|---|---|
| 有料ハート(PAID)のみ返信する | オンなら、有料ハート(バスター)にだけ返信します。無料ハートは何度でも送れるため、オンをおすすめします。 |
| コメント本文 | 無料ハート用の本文です。有料ハート専用の本文が空欄のときは、有料ハートにもこの本文を使います。 |
| 有料ハート(バスター)専用のコメント本文 | 有料ハートにだけ使う本文です。空欄なら、上のコメント本文を使います。 |
| クールダウン(秒) | 返信したあと、次の返信までに空ける時間。0〜3600秒。ハートが続けて届いたときの連投を防ぎます。 |
本文には、次の言葉を入れられます。送るときに、実際の値に置き換わります。
{nickname} | ハートを送ったリスナーのニックネーム。 |
|---|---|
{amount} | ハートの数。 |
例:{nickname}さん、バスター{amount}個ありがとう!
入室メッセージ
リスナーが入室したとき、そのリスナー宛てに、ボットが自動でコメントします。初期値はオフです。
- 本文には
{nickname}を入れられます。例:{nickname}さん、いらっしゃい! - オンにして保存するときは、本文が必須です。
- 入室が重なったときは、2秒間隔で順番に送ります。待ちが20件を超えた分は送りません。
- 配信に接続している間だけ動きます。ボットが固定マネージャーでないと、入室の通知が届かないことがあります。
ファンとしてフォロー
ボットアカウントが、あなたをファンとしてフォローします。「ファンとしてフォロー」を押します。配信中にだけ実行できます。成功すると、ボタンが「フォロー済み」に変わり、日時を表示します。
この表示は、このサービスでフォローに成功した記録をもとにしています。Spoonアプリ側でフォローを解除しても、表示は戻りません。
自動接続
「配信開始時にサーバーが自動で接続する」をオンにすると、ブラウザーを閉じていても、配信が始まるとサーバーが検知して接続します。チャット・ギフト・ハート・入室を取りこぼさず記録できます。
- 配信の開始を、約30秒ごとに確認します。そのため、接続は配信開始の少しあとになることがあります。
- 配信のたびにボットが入室し、リスナーへ告知が表示されます。オンにするときに確認画面が出ます。
- 「配信を切断」を押した配信では、再接続しません。
- 連携の失効やボットのブロックなどで止まったときは、10分間は再試行しません。
配信履歴
ダッシュボードの「配信履歴」の「詳細を見る」から、配信ごとの詳細ページを開きます。配信の一覧から選ぶと、次のタブで見られます。
| 概要 | タイトル、開始・終了時刻、ピークリスナー数、来訪リスナー数、チャット数、ギフト数とその合計、ハート数、リスナー数の推移のグラフ。 |
|---|---|
| チャット | 時刻順のコメント。ニックネームや本文で検索できます。「DJのコメントを除く」で、あなた自身のコメントを隠せます。 |
| リスナー | 入室・退出の時刻。 |
| ギフト | ギフトの送り主、金額、メッセージ。合計も表示します。 |
| ハート | ハートの送り主、数、無料・有料の区別。 |
どのタブも「CSVを保存」で、表示中の内容を表計算ソフトで開けるファイルとして保存できます。
- 配信履歴の一覧には、新しい順に最大100配信を表示します。
- 1つの配信で表示できるチャット・ギフト・ハートは、それぞれ最大5000件です。
- 履歴は、あなたのアカウントでログインしたときだけ見られます。他の人には見えません。
保存されるデータ
Spoon Live Desk が保存するのは、ログインして同意したあなたの配信に関するデータです。
| 連携情報 | あなたのSpoonアカウントのID、Spoonとの連携に使うトークン、ログイン状態(セッション)。 |
|---|---|
| 配信の記録 | 配信のタイトル、開始・終了時刻、リスナー数の推移、コメント数、ギフト数。 |
| チャット | ニックネーム、本文、時刻(あなたのコメントを含む)。 |
| ギフト・ハート | 送り主のニックネーム、数や金額、メッセージ、時刻。 |
| リスナーの入室・退出 | ニックネーム、入室・退出の時刻。 |
| 設定 | このページの「設定」で保存した内容。 |
- データは、あなたのアカウントに紐づけて、Google Cloud(Firestore)に保存します。他のDJのデータと混ざることはありません。
- ログインの状態は、ブラウザーのCookieに保存します。ログイン後30日間は、再ログインなしで使えます。
- リスナーのコメントなど、他の人の発言が含まれます。履歴やCSVの取り扱いには、配慮をお願いします。
- 「ログアウト」しても、保存した配信の記録は消えません。保存データの削除を希望する場合は、運営者にご連絡ください。
できないこと・注意点
- 接続していない間の記録はありません。配信に接続していない間のチャット・ギフト・ハートは、保存されません。このサービスを使い始める前の配信にも、記録はありません。
- 通信が切れると取りこぼします。ネットワークの切断やサーバーの更新で接続が切れている間のイベントは、再接続したあとも復元できません。
- 退出時刻は目安です。Spoonには退出の通知がないため、リスナー一覧から消えたことを約30秒ごとに調べて記録します。最大で約30秒のずれがあります。30秒より短い滞在は、記録されないことがあります。配信が終わったとき、退出が未記録のリスナーは、配信終了の時刻で閉じます。
- 入室メッセージには条件があります。入室の通知を受け取れたときだけ送ります。ボットが固定マネージャーでないと、届かないことがあります。
- ボットが発言できる範囲は限られます。配信のチャットが凍結されているときや、ボットがチャット禁止のときは、送れません。
- 1つのアカウントで、同時に接続できるのは1か所です。別の場所から同じアカウントで接続すると、Spoon側から「重複接続」として切断されます。
困ったときは
ログインできない/「連携が失効しました」と出る
いったん「ログアウト」して、もう一度ログインし、権限に同意し直してください。新しい機能が加わると、権限の同意をやり直す必要があることがあります。
「DJがボットをブロックしているため配信に入室できません」と出る
Spoonアプリで、ボットアカウントのブロックを解除してください。そのあと、「配信を接続」を押します。
「events.chat、events.donation、listeners.read の権限を確認してください」と出る
同意した権限が足りません。「ログアウト」して、ログインし直し、すべての権限に同意してください。
配信しているのに、チャットが表示されない
- 「配信を接続」を押して、ボタンが「配信を切断」に変わっているか確認してください。
- 「配信を切断」を押した配信は、自動では再接続しません。
- 別の場所(別のブラウザーやスマートフォン)で、同じアカウントを接続していませんか。接続は1か所だけです。
リスナーが入室しても、入室メッセージが送られない
- 設定で、「入室メッセージを送る」がオンで、本文が入っているか確認してください。
- ボットが固定マネージャーかどうか確認してください。入室の通知が届かないと、送れません。
- 入室メッセージが重なると、順番に送るため、少し遅れます。
ハートをもらったのに、返信されない
- 設定で、「自動返信を有効にする」がオンか確認してください。
- 「有料ハートのみ返信する」がオンのときは、無料ハートには返信しません。
- クールダウンの時間内は返信しません。連続で届いたときは、最初の1回だけ返信します。
「ファンとしてフォロー」ができない
フォローは配信中にだけできます。配信を始めてから、もう一度押してください。ボットをブロックしているときは、フォローできません。
過去の配信の詳細が空っぽ
その配信の間に、接続していなかった可能性があります。接続していない間の記録は残りません。自動接続をオンにすると、取りこぼしを減らせます。
配信履歴を開くとエラーになる
しばらくしてから、もう一度開いてください。続くときは、運営者にご連絡ください。