ban

abstract suspend fun ban(duration: Duration)(source)

禁言此成员。 禁言时长范围应当在 1m ~ 30d 之间, 不过 duration 最终会被转为秒值。 如果值为 Duration.ZERO 或最终秒值为 0 则等同于 unban, 如果转化后的秒值为负数,则会抛出 IllegalArgumentException

不会在代码中校验时长的最大有效值,这会直接交给OneBot服务端处理。

Parameters

duration

禁言时长。 通常来讲,时间范围应当在 1m ~ 30d 之间。 如果值为 Duration.ZERO 则等同于 unban

See also

Throws

如果参数代表的秒值 小于0

某些无法得知群号的情况下抛出的异常

任何请求API时可能得到的异常


abstract suspend fun ban(duration: Long, unit: TimeUnit)(source)

禁言此成员。 禁言时长范围应当在 1m ~ 30d 之间, 不过 duration 最终会根据 unit 被转为秒值。 如果最终秒值为 0 则等同于 unban, 如果 duration 为负数,则会抛出 IllegalArgumentException

不会在代码中校验时长的最大有效值,这会直接交给OneBot服务端处理。

Parameters

duration

禁言时长

unit

duration 的时间单位

See also

Throws

如果参数代表的秒值 小于0

某些无法得知群号的情况下抛出的异常

任何请求API时可能得到的异常