前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >开始第一个QQ机器人【适用于v1.9-v1.X】

开始第一个QQ机器人【适用于v1.9-v1.X】

作者头像
newbe36524
发布2020-03-16 14:45:22
9530
发布2020-03-16 14:45:22
举报

本示例将会使用”嘤鹉学舌”这个小插件的实现来演示如何使用Newbe.Mahua实现第一个机器人插件。

入坑提示

建议开发者先根据自身需求结合表格,选择属于自己的专属开发框架,避免浪费时间。

  1. 编写一套代码就能在多个平台运行
  2. 支持使用除了C#之外的开发语言来开发
  3. 我希望他足够简单,不用学习太多就能掌握,通常只需要半个小时就能掌握所有内容
  4. 我希望社区的反馈足够快,有问题都可以帮我解决

SDK名称

(1)

(2)

(3)

(4)

论坛中的其他SDK

Jie2GG.Native.Csharp.Frame

Newbe.Mahua V2

Newbe.Mahua V1

论坛其他SDK的链接

插件功能

自动将发送者的消息回发给发送人,嘤鹉(Parrot,其实是说嘤嘤嘤怪)学舌。

基础环境要求

  • Windows 操作系统
  • .Net Framework 4.5.2 及以上
  • Powershell 5.0及以上,仅开发环境要求
  • .Net Core SDK 2.2 及以上,仅开发环境要求

IDE

开发者可以任选以下任意一款IDE

  • Visual Studio 2017(VS2015 update 3 理论上也能够开发,但开发遇到的问题,需自行解决)
  • Visual Studio Code
  • Rider(Newbe更加推荐)

设置Powershell执行策略限制

简单来说,使用管理员权限在cmd中运行以下命令:

代码语言:javascript
复制
powershell -command "Set-ExecutionPolicy RemoteSigned -Force"

参考资料:http://www.pstips.net/powershell-create-and-start-scripts.html

安装项目模板

在安装好 .Net Core SDK 之后,启动控制台运行以下命令:

代码语言:javascript
复制
dotnet new -i Newbe.Mahua.Template

出现以下内容,则说明项目模板已经安装成功。

新建项目

项目模板包含有五个,包含四个对应平台的模板和一个全平台的模板。

名称

说明

newbe.mahua.all

全平台

newbe.mahua.cqp

酷 Q

newbe.mahua.mpq

MyPcQQ

newbe.mahua.qqlight

QQLight

本示例使用全平台模板 newbe.mahua.all 进行演示。

特别注意:为了确保新建的项目的能够在所有平台运行,项目名称至少需要包含 AAA.BBB.CCC 三段。

本次实例使用名称 Newbe.Mahua.Plugins.Parrot 进行演示。

使用 Rider

直接使用 Rider 创建项目,可以在 Other 模板分组中找到该框架相关的模板。

等待 Rider 创建完毕后,进入新建的项目文件夹中。使用控制台执行更新命令,更新相应的组件包到最新:

代码语言:javascript
复制
build.bat UpdateMahuaPackages

使用其他 IDE

新建一个空的文件夹,启动控制台,cd进入该文件夹,运行以下命令:

代码语言:javascript
复制
REM 创建解决方案
dotnet new sln -n Newbe.Mahua.Plugins.Parrot

REM 创建项目文件夹
mkdir Newbe.Mahua.Plugins.Parrot

REM 切换目录
cd Newbe.Mahua.Plugins.Parrot

REM 使用模板创建项目
dotnet new newbe.mahua.all -n Newbe.Mahua.Plugins.Parrot
y

REM 切换目录
cd ../

REM 将项目添加到解决方案中
dotnet sln Newbe.Mahua.Plugins.Parrot.sln add Newbe.Mahua.Plugins.Parrot/Newbe.Mahua.Plugins.Parrot.csproj
echo finished

初次执行这些命令需要1-2分钟时间。

具体效果如图所示:

修改插件基本信息

打开PluginInfo.cs文件,按照实际需求和注释内容进行修改。

代码语言:javascript
复制
namespace Newbe.Mahua.Plugins.Parrot
{
    /// <summary>
    /// 本插件的基本信息
    /// </summary>
    public class PluginInfo : IPluginInfo
    {
        /// <summary>
        /// 版本号,建议采用 主版本.次版本.修订号 的形式
        /// </summary>
        public string Version { get; set; } = "1.0.0";

        /// <summary>
        /// 插件名称
        /// </summary>

        public string Name { get; set; } = "嘤鹉学舌";

        /// <summary>
        /// 作者名称
        /// </summary>
        public string Author { get; set; } = "Newbe";

        /// <summary>
        /// 插件Id,用于唯一标识插件产品的Id,至少包含 AAA.BBB.CCC 三个部分
        /// </summary>
        public string Id { get; set; } = "Newbe.Mahua.Plugins.Parrot";

        /// <summary>
        /// 插件描述
        /// </summary>
        public string Description { get; set; } = "嘤鹉学舌,是一个使用Mahua框架开发的第一个插件。该插件实现将好友的私聊消息回发给好友的功能。";
    }
}

添加”接收好友消息事件”代码实现

新建出来的项目中包含一个 ItemTemplate 文件夹,里面包含了所有需要的项模板。

注意,这个文件夹默认没有包含到项目中,需要使用资源管理器进行查看。

ItemTemplate/MahuaEvent/PrivateMessageReceivedMahuaEvent.cs

文件复制到 MahuaEvents/PrivateMessageReceivedMahuaEvent.cs,并使用IDE将复制后的文件包含在项目中。

处理事件

PrivateMessageFromFriendReceivedMahuaEvent.cs中,调用IMahuaApi,将好友消息回发给好友,实现嘤鹉学舌的效果。

代码语言:javascript
复制
using Newbe.Mahua.MahuaEvents;
using System.Threading.Tasks;

namespace Newbe.Mahua.Plugins.Parrot.MahuaEvents
{
    /// <summary>
    /// 来自好友的私聊消息接收事件
    /// </summary>
    public class PrivateMessageFromFriendReceivedMahuaEvent
        : IPrivateMessageFromFriendReceivedMahuaEvent
    {
        private readonly IMahuaApi _mahuaApi;

        public PrivateMessageFromFriendReceivedMahuaEvent(
            IMahuaApi mahuaApi)
        {
            _mahuaApi = mahuaApi;
        }

        public void ProcessFriendMessage(PrivateMessageFromFriendReceivedContext context)
        {
          // 戳一戳
          _mahuaApi.SendPrivateMessage(context.FromQq)
              .Shake()
              .Done();

          // 嘤嘤嘤,换行,重复消息
          _mahuaApi.SendPrivateMessage(context.FromQq)
              .Text("嘤嘤嘤:")
              .Newline()
              .Text(context.Message)
              .Done();

          // 异步发送消息,不能使用 _mahuaApi 实例,需要另外开启Session
         Task.Factory.StartNew(() =>
         {
             using (var robotSession = MahuaRobotManager.Instance.CreateSession())
             {
                 var api = robotSession.MahuaApi;
                 api.SendPrivateMessage(context.FromQq, "异步的嘤嘤嘤");
             }
         });
        }
    }
}

在模块中注册事件

打开MahuaModule.cs文件,在MahuaEventsModule中注册刚刚添加的PrivateMessageFromFriendReceivedMahuaEvent

代码语言:javascript
复制
using Autofac;
using Newbe.Mahua.MahuaEvents;
using Newbe.Mahua.Plugins.Parrot.MahuaEvents;

namespace Newbe.Mahua.Plugins.Parrot
{
    /// <summary>
    /// Ioc容器注册
    /// </summary>
    public class MahuaModule : IMahuaModule
    {
        public Module[] GetModules()
        {
            // 可以按照功能模块进行划分,此处可以改造为基于文件配置进行构造。实现模块化编程。
            return new Module[]
            {
                new PluginModule(),
                new MahuaEventsModule(),
            };
        }

        /// <summary>
        /// 基本模块
        /// </summary>
        private class PluginModule : Module
        {
            protected override void Load(ContainerBuilder builder)
            {
                base.Load(builder);
                // 将实现类与接口的关系注入到Autofac的Ioc容器中。如果此处缺少注册将无法启动插件。
                // 注意!!!PluginInfo是插件运行必须注册的,其他内容则不是必要的!!!
                builder.RegisterType<PluginInfo>()
                    .As<IPluginInfo>();

            }
        }

        /// <summary>
        /// <see cref="IMahuaEvent"/> 事件处理模块
        /// </summary>
        private class MahuaEventsModule : Module
        {
            protected override void Load(ContainerBuilder builder)
            {
                base.Load(builder);
                // 将需要监听的事件注册,若缺少此注册,则不会调用相关的实现类
                builder.RegisterType<PrivateMessageFromFriendReceivedMahuaEvent>()
                    .As<IPrivateMessageFromFriendReceivedMahuaEvent>();
            }
        }
    }
}

生成与打包

生成项目,然后双击位于项目根目录的build.bat文件。

复制文件到机器人平台

bin目录下会按照当前安装的平台生成相应的目录。本示例将会生成CQP、Amanda和MPQ三个目录。

分别将三个文件夹下的所有文件和文件夹都复制到对应的机器人平台根目录

以CQP为例,进行一次复制过程如下图所示:

各机器人软件下载地址:

启用插件

各个机器人平台的启用方式各不相同。

CQP

按照下图所示,开启开发者模式。

打开插件管理将插件启用。

MPQ、QQLight

打开插件管理将插件启用。

成功!

发送消息给机器人,你就会收到机器人回发的信息。

机器人插件启动可能需要一段时间,并且大多数平台都会丢弃离线信息,可能需要等待一会儿在发送。

继续了解

Newbe.Mahua 1.X 主要特性介绍与常见问题讲解

教程链接

发布说明

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2018-06-102,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 入坑提示
    • 论坛其他SDK的链接
    • 插件功能
    • 基础环境要求
    • IDE
    • 设置Powershell执行策略限制
    • 安装项目模板
    • 新建项目
      • 使用 Rider
        • 使用其他 IDE
        • 修改插件基本信息
        • 添加”接收好友消息事件”代码实现
          • 处理事件
          • 在模块中注册事件
          • 生成与打包
          • 复制文件到机器人平台
          • 启用插件
            • CQP
              • MPQ、QQLight
              • 成功!
              • 继续了解
              • 教程链接
              • 发布说明
              相关产品与服务
              容器服务
              腾讯云容器服务(Tencent Kubernetes Engine, TKE)基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务,覆盖 Serverless、边缘计算、分布式云等多种业务部署场景,业内首创单个集群兼容多种计算节点的容器资源管理模式。同时产品作为云原生 Finops 领先布道者,主导开源项目Crane,全面助力客户实现资源优化、成本控制。
              领券
              问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档