ボイス通話・配信通知機能(/voice_notify)

指定したボイスチャンネルで通話や画面配信が始まったとき、設定したチャンネルでロールへお知らせできる機能です。特定ロールを持つユーザーの参加・配信だけに絞ることもできます。

使い方

基本の登録例:

/voice_notify action:登録・更新 voice_channel:雑談VC text_channel:#voice-news notify_role:@通話通知

引数

解除ではvoice_channelを指定します。一覧ではaction以外の引数は不要です。

応答・返り値

• 監視するボイスチャンネル
• 通知先テキストチャンネル
• メンションする通知ロール
• 通話・配信の有効状態
• 参加者条件ロール
• 通話開始、対象ユーザーの参加、画面配信開始のお知らせ
• 登録・更新・解除の完了メッセージ

必要条件・権限

• 設定の登録・更新・解除・一覧表示には「サーバーの管理」権限が必要です。
• botには通知先でメッセージ送信と埋め込みリンクの権限が必要です。
• 通知ロールはメンション可能にするか、botがそのロールをメンションできる権限を持っている必要があります。
• @everyoneは通知ロールや参加者条件に指定できません。

制限・仕様

• 参加者条件を省略すると、監視VCが無人から有人になった時に通話開始を通知します。
• 参加者条件を指定すると、そのロール保持者が監視VCへ参加した時に通知します。
• 参加者条件を指定した場合、画面配信も条件ロールを持つユーザーだけが通知対象です。
• 通話通知と配信通知は個別に有効・無効を設定できます。
• 通話通知と配信通知を両方無効にはできません。
• Botのボイス参加は通話開始通知の対象外です。
• 配信通知は画面共有の開始が対象です。カメラ映像の開始は対象外です。
• 同じユーザーによる短時間の連続通知は抑制されます。

使用例

すべてのユーザーによる通話開始と画面配信開始を通知:

/voice_notify action:登録・更新 voice_channel:雑談VC text_channel:#voice-news notify_role:@通話通知

@配信者を持つユーザーの参加・配信だけを通知:

/voice_notify action:登録・更新 voice_channel:配信VC text_channel:#stream-news notify_role:@視聴者 required_role:@配信者

画面配信だけを通知:

/voice_notify action:登録・更新 voice_channel:配信VC text_channel:#stream-news notify_role:@配信通知 notify_call:False notify_stream:True

設定の確認と解除:

/voice_notify action:一覧
/voice_notify action:解除 voice_channel:配信VC

エラー・注意点

• 通知が届かない場合は、通知先チャンネルと通知ロールが削除されていないか確認してください。
• ロールがメンションされない場合は、ロールのメンション設定とbotの権限を確認してください。
• 対象ユーザーが参加しても通知されない場合は、required_roleの指定とユーザーのロールを確認してください。
• 通話通知と配信通知の両方を無効にした設定は登録できません。
• 設定を変更する場合は、同じボイスチャンネルを新しい内容で再登録してください。