NoneBot2 平台接口调用指南：解锁高级消息功能-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00040/article/details/148465615

NoneBot2 平台接口调用指南：解锁高级消息功能

nonebot2 跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python 项目地址: https://gitcode.com/gh_mirrors/no/nonebot2

前言

在机器人开发中，仅仅发送普通文本消息往往无法满足复杂场景的需求。NoneBot2 作为一个高度可扩展的 Python 异步机器人框架，提供了强大的平台接口调用能力，让开发者能够充分利用各平台的特殊功能。本文将深入讲解如何在 NoneBot2 中调用平台接口，实现更丰富的交互体验。

平台特殊消息发送

基础概念

NoneBot2 通过协议适配器支持不同平台的特殊消息类型。与普通文本消息不同，这些特殊消息能够呈现更丰富的视觉效果和交互形式。

消息类型对比

| 消息类型 | 跨平台兼容性 | 典型用途 | |---------|------------|---------| | 纯文本(str) | 高 | 基础消息发送 | | 消息序列 | 中 | 组合消息段 | | 消息段 | 低 | 平台特殊内容 | | 消息模板 | 高(纯文本形式) | 动态消息生成 |

实战示例

以下是一个天气插件示例，展示了如何发送控制台特有的 emoji 和 markdown 消息：

import inspect
from nonebot.adapters.console import MessageSegment

@weather.got("location", prompt=MessageSegment.emoji("question") + "请输入地名")
async def got_location(location: str = ArgPlainText()):
    result = await weather.send(
        MessageSegment.markdown(
            inspect.cleandoc(
                f"""
                # {location}

                - 今天

                   ⛅ 多云 20℃~24℃
                """
            )
        )
    )

代码解析：

MessageSegment.emoji("question") 生成问号emoji
MessageSegment.markdown() 渲染markdown格式内容
inspect.cleandoc() 清理多行字符串的缩进

平台API调用详解

获取Bot对象

调用平台API前，需要先获取Bot对象。NoneBot2提供了两种主要方式：

1. 依赖注入方式（推荐）

from nonebot.adapters import Bot

@weather.got("location", prompt="请输入地名")
async def got_location(bot: Bot, location: str = ArgPlainText()):
    # 使用bot对象调用API
    ...

类型注解说明：

使用Bot基类：接受任何平台的Bot对象
使用特定适配器Bot类型：仅接受指定平台的Bot对象

2. 全局获取方式

from nonebot import get_bot

# 获取默认Bot
bot = get_bot()

# 获取指定ID的Bot
bot = get_bot("bot_id")

API调用方法

NoneBot2提供了两种API调用方式：

直接调用法

# 获取用户信息示例
user_info = await bot.get_user_info(user_id=12345678)

通用调用法

# 同上功能的另一种写法
user_info = await bot.call_api("get_user_info", user_id=12345678)

实际应用案例

让我们扩展之前的天气插件，添加控制台响铃提醒功能：

from nonebot.adapters.console import Bot, MessageSegment

@weather.got("location", prompt=MessageSegment.emoji("question") + "请输入地名")
async def got_location(bot: Bot, location: str = ArgPlainText()):
    await weather.send(
        MessageSegment.markdown(
            inspect.cleandoc(
                f"""
                # {location}

                - 今天

                   ⛅ 多云 20℃~24℃
                """
            )
        )
    )
    # 调用控制台响铃API
    await bot.bell()