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

本文链接：https://blog.youkuaiyun.com/gitblog_01194/article/details/148465589

NoneBot2 平台接口调用指南：解锁机器人高级功能

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

前言

在 NoneBot2 框架中，平台接口调用是扩展机器人功能的重要方式。本文将深入讲解如何通过 NoneBot2 调用各平台特有的 API 接口，实现超越基础文本交互的丰富功能。

平台接口调用的核心概念

什么是平台接口

平台接口是指各聊天平台（如QQ、微信、即时通讯工具等）提供的特殊功能API。这些接口可以实现：

发送富媒体消息（图片、语音、Markdown等）
获取用户/群组信息
执行平台特有操作（如QQ的戳一戳）

NoneBot2 的适配器机制

NoneBot2 通过协议适配器抽象了不同平台的接口差异，开发者可以通过统一的API调用方式操作不同平台的功能。

发送平台特殊消息

消息类型的选择

在 NoneBot2 中，我们可以发送多种类型的消息：

纯文本消息：所有平台通用
平台特有消息：如Markdown、Emoji等，仅特定平台支持

实际应用示例

以下是一个发送天气信息的示例，结合了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℃
                """
            )
        )
    )

这段代码实现了：

使用Emoji作为提示符
以Markdown格式发送天气信息
保持代码整洁的缩进格式

调用平台API的完整流程

第一步：获取Bot对象

获取Bot对象有两种主要方式：

方式一：通过依赖注入（推荐）

from nonebot.adapters import Bot

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

这种方式会自动注入正确类型的Bot对象。

方式二：通过全局方法获取

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℃
                """
            )
        )
    )
    await bot.bell()  # 调用终端响铃API