模块 linlang.api
程序包 api.linlang.messenger

类 LinMessage

java.lang.Object
api.linlang.messenger.LinMessage
public final class LinMessage extends Object
不可变的一次性消息定义。

普通发送场景应优先使用 LinMessenger 的便捷方法。只有需要覆盖前缀、降级或标题时长时， 才需要直接构造该对象。

  • 方法详细资料

    • chat

      public static LinMessage chat(TextSource content)
      创建聊天消息。
      参数:
      content - 消息内容
      返回:
      聊天消息

    • chat

      public static LinMessage chat(String content)
      创建聊天消息。
      参数:
      content - 高级字符串源码
      返回:
      聊天消息

    • actionBar

      public static LinMessage actionBar(TextSource content)
      创建动作栏消息。
      参数:
      content - 消息内容
      返回:
      动作栏消息

    • actionBar

      public static LinMessage actionBar(String content)
      创建动作栏消息。
      参数:
      content - 高级字符串源码
      返回:
      动作栏消息

    • title

      public static LinMessage title(TextSource title, TextSource subtitle)
      创建标题消息。
      参数:
      title - 主标题
      subtitle - 副标题
      返回:
      标题消息

    • title

      public static LinMessage title(String title, String subtitle)
      创建标题消息。
      参数:
      title - 主标题高级字符串源码
      subtitle - 副标题高级字符串源码
      返回:
      标题消息

    • args

      public LinMessage args(Object... keyValues)
      设置名称和值交替排列的变量。
      参数:
      keyValues - 名称和值交替排列的变量
      返回:
      新消息对象

    • args

      public LinMessage args(Map<String,?> values)
      设置变量映射。
      参数:
      values - 变量映射
      返回:
      新消息对象

    • args

      public LinMessage args(TextArgs args)
      设置变量集合。
      参数:
      args - 变量集合
      返回:
      新消息对象

    • prefix

      public LinMessage prefix(PrefixMode mode)
      设置前缀策略。
      参数:
      mode - 前缀策略
      返回:
      新消息对象

    • withoutPrefix

      public LinMessage withoutPrefix()
      明确省略前缀。
      返回:
      新消息对象

    • fallback

      public LinMessage fallback(FallbackPolicy policy)
      设置通道不受支持时的处理策略。
      参数:
      policy - 降级策略
      返回:
      新消息对象

    • times

      public LinMessage times(TitleTimes times)
      设置标题显示时长。
      参数:
      times - 标题时长
      返回:
      新消息对象
      抛出:
      IllegalStateException - 当前消息不是标题时

    • times

      public LinMessage times(int fadeIn, int stay, int fadeOut)
      设置标题显示时长。
      参数:
      fadeIn - 淡入时长
      stay - 停留时长
      fadeOut - 淡出时长
      返回:
      新消息对象

    • locale

      public LinMessage locale(String locale)
      覆盖本条消息解析语言引用时使用的语言。
      参数:
      locale - 语言标签；空字符串表示使用服务当前语言
      返回:
      新消息对象

    • channel

      public MessageChannel channel()
      返回消息通道。
      返回:
      消息通道

    • content

      public TextSource content()
      返回主消息内容来源。
      返回:
      主消息内容来源

    • subtitle

      public TextSource subtitle()
      返回副标题来源。
      返回:
      标题消息的副标题来源；其他通道为 null

    • args

      public TextArgs args()
      返回消息变量。
      返回:
      不可变变量集合

    • prefixMode

      public PrefixMode prefixMode()
      返回前缀策略。
      返回:
      前缀策略

    • fallbackPolicy

      public FallbackPolicy fallbackPolicy()
      返回通道不受支持时的处理策略。
      返回:
      降级策略

    • titleTimes

      public TitleTimes titleTimes()
      返回标题时长。
      返回:
      标题时长

    • locale

      public String locale()
      返回本条消息指定的解析语言。
      返回:
      语言标签；空字符串表示使用服务当前语言