mirai/docs/guide_quick_start.md

Mirai Guide - Quick Start

由于 mirai 项目在快速推进中，因此内容时有变动，本文档的最后更新日期为2020/5/11，对应版本1.0-RC2-1

本文适用于对 Kotlin 较熟悉的开发者,
使用 mirai 作为第三方依赖库引用任意一个 Kotlin, Java 或其他 JVM 平台的项目

若你希望一份更基础的教程, 请参阅: mirai-guide-getting-started

构建需求

• Kotlin 1.3.71 (必须)
• JDK 6 或更高 (必须)

获取 Demo

可在 mirai-demos 中获取已经配置好依赖的示例项目.

Quick Start

请将 VERSION 替换为 mirai-core 的最新版本号(如 0.23.0):

添加依赖

Maven

Kotlin 在 Maven 上只支持 JVM 平台.

<repositories>
    <repository>
        <id>jcenter</id>
        <url>https://jcenter.bintray.com/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>net.mamoe</groupId>
        <artifactId>mirai-core-qqandroid</artifactId>
        <version>0.23.0</version> <!-- 替换版本为最新版本 -->
    </dependency>
</dependencies>

Gradle

Mirai 只发布在 jcenter, 因此请确保添加 jcenter() 仓库：

repositories{
  jcenter()
}

注意： Mirai 核心由 API 模块（mirai-core）和协议模块组成。
只添加 API 模块将无法正常工作。
现在只推荐使用 QQAndroid 协议，请参照下文选择对应目标平台的依赖添加。

jvm (JVM 平台源集)

implementation("net.mamoe:mirai-core-qqandroid:VERSION")

common (Kotlin 多平台项目的通用源集)

implementation("net.mamoe:mirai-core-qqandroid-common:VERSION")

android (Android 平台源集) 注意: 在 KT-37152 修复前, mirai 无法支持 Android 平台目标.

implementation("net.mamoe:mirai-core-qqandroid-android:VERSION")

开始使用

val bot = Bot(qqId, password).alsoLogin()
bot.subscribeAlways<GroupMessageEvent> { event ->
  if (event.message.content.contains("你好")) {
    reply("你好!")
  } else if (event.message.content.contains("你好")) {
     File("C:\\image.png").sendAsImage()
  } 
}

bot.subscribeAlways<MemberPermissionChangedEvent> { event ->
  if (event.kind == BECOME_OPERATOR)
    reply("${event.member.id} 成为了管理员")
}