replyWithDice method

Future<Message> replyWithDice({
  1. DiceEmoji emoji = DiceEmoji.dice,
  2. int? messageThreadId,
  3. bool? disableNotification,
  4. bool? protectContent,
  5. ReplyMarkup? replyMarkup,
  6. ReplyParameters? replyParameters,
  7. String? businessConnectionId,
  8. String? messageEffectId,
  9. bool? allowPaidBroadcast,
  10. int? directMessagesTopicId,
  11. SuggestedPostParameters? suggestedPostParameters,
})

Sends a dice animation to the current chat.

This method sends an animated dice that shows a random value. Supports different dice types including regular dice, darts, basketball, etc. All parameters from the RawAPI.sendDice method are supported.

Example:

await ctx.replyWithDice(); // Default dice emoji
await ctx.replyWithDice(emoji: DiceEmoji.basketball);

// With additional parameters
await ctx.replyWithDice(
  emoji: DiceEmoji.dart,
  messageThreadId: 123,
  messageEffectId: 'fire',
);

Implementation

Future<Message> replyWithDice({
  DiceEmoji emoji = DiceEmoji.dice,
  int? messageThreadId,
  bool? disableNotification,
  bool? protectContent,
  ReplyMarkup? replyMarkup,
  ReplyParameters? replyParameters,
  String? businessConnectionId,
  String? messageEffectId,
  bool? allowPaidBroadcast,
  int? directMessagesTopicId,
  SuggestedPostParameters? suggestedPostParameters,
}) async {
  final chatId = _getChatId();
  _verifyInfo([chatId], APIMethod.sendDice);

  return api.sendDice(
    chatId!,
    emoji: emoji,
    messageThreadId: _threadId(messageThreadId),
    disableNotification: disableNotification,
    protectContent: protectContent,
    replyMarkup: replyMarkup,
    replyParameters: replyParameters,
    businessConnectionId: _businessConnectionId(businessConnectionId),
    messageEffectId: messageEffectId,
    allowPaidBroadcast: allowPaidBroadcast,
    directMessagesTopicId: directMessagesTopicId,
    suggestedPostParameters: suggestedPostParameters,
  );
}