指定したテキストチャンネルに天気予報メッセージを作成し、設定した間隔で同じメッセージを編集更新する機能です。登録、解除、一覧表示の3コマンドで管理します。
使い方
| 操作 |
形式 |
内容 |
| 登録 |
/weather_auto_register channel:<チャンネル> location:<地域または住所> interval_minutes:<分> |
指定チャンネルに天気自動更新を登録します。 |
| 解除 |
/weather_auto_unregister channel:<チャンネル> |
指定チャンネルの天気自動更新を停止します。 |
| 一覧 |
/weather_auto_list |
このサーバーの天気自動更新チャンネルを表示します。 |
引数
| コマンド |
引数 |
説明 |
/weather_auto_register |
channel |
必須。天気情報を自動更新する通常テキストチャンネルです。 |
/weather_auto_register |
location |
必須。地域名、都道府県名、住所の一部を指定します。例: 東京, 東京都新宿区, 福岡県 久留米。入力補完に対応しています。 |
/weather_auto_register |
interval_minutes |
任意。更新間隔です。30分から1440分まで指定できます。省略時は180分です。 |
/weather_auto_unregister |
channel |
任意。解除する通常テキストチャンネルです。省略時は現在のチャンネルを解除します。 |
/weather_auto_list |
なし |
引数はありません。 |
応答・返り値
/weather_auto_register は登録時にすぐ天気メッセージを作成し、登録結果を実行者本人だけに表示します。- 登録後は設定した間隔で同じメッセージを編集し、最新の3日分予報に更新します。
/weather_auto_unregister は停止したか、未登録だったかを実行者本人だけに表示します。/weather_auto_list は登録済みチャンネル、地域、更新間隔の一覧を実行者本人だけに表示します。
必要条件・権限
- 各コマンドはサーバー内でのみ使用できます。
/weather_auto_register と /weather_auto_unregister の実行者にはチャンネルの管理権限が必要です。/weather_auto_list は特別な実行者権限なしで使用できます。- 登録先チャンネルで、botにメッセージ送信、埋め込みリンク、メッセージ履歴を読む権限が必要です。
制限・仕様
- 更新間隔は30分から1440分までです。省略時は180分です。
- 自動更新ループは約60秒ごとに登録状態を確認します。
- 地域指定は
/weather と同じく、近い代表予報地点へ解決します。
- 既存の自動更新メッセージが削除された場合は、新しいメッセージを作成して以後それを更新します。
使用例
/weather_auto_register channel:#weather location:東京 interval_minutes:180
/weather_auto_register channel:#weather location:東京都新宿区 interval_minutes:60
/weather_auto_unregister channel:#weather
/weather_auto_list
エラー・注意点
- 30分未満の更新間隔は指定できません。
- botが対象チャンネルのメッセージ履歴を読めない場合、既存メッセージを編集できません。
- 天気情報を取得できない場合、その回の自動更新が失敗することがあります。
コメント