Bot のオプション¶

Bot(...) のすべてのオプションです。どれもキーワード専用引数です。各オプションは、ガイドで文脈とあわせて説明しています。

ゲートウェイと識別¶

オプション	既定値	意味
`intents`	`Intents.DEFAULT`	要求するインテント。既定値には 3 つの特権インテントを除くすべてのインテントが含まれます
`status`	`Status.ONLINE`	ログイン時のプレゼンスのステータス
`activities`	`()`	ログイン時のアクティビティ。`bostie.activity` で組み立てます
`afk`	`False`	Bot が自分を離席中として報告するかどうか
`idle_since`	`None`	Bot がアイドル状態になった `datetime`
`large_threshold`	50	50 から 250。メンバー数がこの値を超えると、Discord はサーバーのペイロードからオフラインのメンバーを省きます
`shard_count`	`"auto"`	シャードの数。`"auto"` にすると Discord の推奨値を使います
`shard_ids`	`"all"`	このプロセスが動かすシャード。`shard_count` を明示する必要があります
`before_identify`	`None`	各 Identify の前に await される `async def f(shard_id)`。プロセス間の調整に使います
`session_file`	`None`	`close()` がセッションを保存し、次の `start()` がそれを再開するためのパス
`guild_ready_timeout`	2.0	新しいサーバーが届かないまま経過すると、シャードが準備完了とみなされるまでの秒数

オプション	既定値	意味
`auto_sync`	`True`	起動時、Discord 上のコマンドと異なる場合にコマンドを同期します
`dev_guilds`	`()`	グローバルではなくコマンドを登録する先のサーバー ID
`contexts`	`None`	コマンドやルーターが別に指定しない限り、グローバルコマンドを使える場所
`integration_types`	`None`	コマンドやルーターが別に指定しない限り、グローバルコマンドを持つインストールの種類
`translate`	`None`	翻訳または `None` を返す `f(text, locale)`
`auto_defer`	2.5	応答のないインタラクションを遅延応答にするまでの秒数。`None` で無効になります
`allowed_mentions`	`AllowedMentions(parse=("users", "roles"))`	既定で通知を送ることができるメンション
`owner_ids`	`None`	`is_owner` が通すユーザー。`None` の場合はアプリのオーナーまたはチームを読み込みます

オプション	既定値	意味
`cache`	`True`	キャッシュを保持します。`False` の場合は何も保持しません
`members`	`False`	すべてのメンバーを保持します。`Intents.GUILD_MEMBERS` が必要です
`chunk_members`	`True`	`members=True` のとき、起動時に Discord が省いたメンバーを要求します
`presences`	`False`	プレゼンスを保持します。`Intents.GUILD_PRESENCES` が必要です
`max_messages`	0	保持する最新メッセージの数
`max_dm_channels`	0	保持する最新の DM チャンネルの数

オプション	既定値	意味
`http_settings`	`HTTPSettings()`	REST リクエストのレート制限、リトライ、タイムアウト、プロキシ
`api_url`	`None`	REST のベース URL。指定がなければ `BOSTIE_API_URL`、それもなければ Discord の URL を使います
`voice`	`voice.Defaults()`	すべての接続の出発点となるボイスの設定
`shutdown_grace`	0.0	`close()` が実行中のハンドラーをキャンセルする前に与える猶予の秒数

run(token=None, loop_factory=None) と start(token=None) はトークンを受け取り、既定では BOSTIE_TOKEN を使います。