Guide de migration

De la version v2 , seulement JDK 17+ et SpringBoot 3.0.0+
Pour plus de détails, consultez le Guide de migration du document du projet V2

Start

Dépendances à introduire

Lors de l'introduction de la dépendance, veuillez remplacer la version de la latest version de Maven Central .

Maven

< dependency >
    < groupId >com.mikuacgroupId >
    < artifactId >shiroartifactId >
    < version >latestversion >
dependency >

Gradle Kotlin DSL

implementation( " com.mikuac:shiro:latest " )

Gradle Groovy DSL

implementation ' com.mikuac:shiro:latest '

Plugle exemplaire -in

Note d'appel

Écrivez le fichier de configuration application.yaml ou référez-vous au fichier de configuration avancé

 server :
  port : 5000

 @ Shiro
@ Component
public class ExamplePlugin {
    // 更多用法详见 @MessageHandlerFilter 注解源码

    // 当机器人收到的私聊消息消息符合 cmd 值 "hi" 时，这个方法会被调用。
    @ PrivateMessageHandler
    @ MessageHandlerFilter ( cmd = "hi" )
    public void fun1 ( Bot bot , PrivateMessageEvent event , Matcher matcher ) {
        // 构建消息
        String sendMsg = MsgUtils . builder (). face ( 66 ). text ( "Hello, this is shiro demo." ). build ();
        // 发送私聊消息
        bot . sendPrivateMsg ( event . getUserId (), sendMsg , false );
    }

    // 如果 at 参数设定为 AtEnum.NEED 则只有 at 了机器人的消息会被响应
    @ GroupMessageHandler
    @ MessageHandlerFilter ( at = AtEnum . NEED )
    public void fun2 ( GroupMessageEvent event ) {
        // 以注解方式调用可以根据自己的需要来为方法设定参数
        // 例如群组消息可以传递 GroupMessageEvent, Bot, Matcher 多余的参数会被设定为 null
        System . out . println ( event . getMessage ());
    }

    // 同时监听群组及私聊消息 并根据消息类型（私聊，群聊）回复
    @ AnyMessageHandler
    @ MessageHandlerFilter ( cmd = "say hello" )
    public void fun3 ( Bot bot , AnyMessageEvent event ) {
        bot . sendMsg ( event , "hello" , false );
    }
}

Réécrivez la méthode parent

Le plug-in écrit par la méthode d'annotation n'a pas besoin de définir la plugin-list de liste de plug-in
Le fichier de configuration du serveur resources/application.yaml ajoute le contenu suivant
La liste des plug MESSAGE_BLOCK est exécutée dans l'ordre.

Écrivez le fichier de configuration application.yaml ou référez-vous au fichier de configuration avancé

 server :
  port : 5000
shiro :
  plugin-list :
    - com.example.bot.plugins.ExamplePlugin

 @ Component
public class ExamplePlugin extends BotPlugin {

    @ Override
    public int onPrivateMessage ( Bot bot , PrivateMessageEvent event ) {
        if ( "hi" . equals ( event . getMessage ())) {
            // 构建消息
            String sendMsg = MsgUtils . builder ()
                    . face ( 66 )
                    . text ( "hello, this is shiro example plugin." )
                    . build ();
            // 发送私聊消息
            bot . sendPrivateMsg ( event . getUserId (), sendMsg , false );
        }
        // 返回 MESSAGE_IGNORE 执行 plugin-list 下一个插件，返回 MESSAGE_BLOCK 则不执行下一个插件
        return MESSAGE_IGNORE ;
    }

    @ Override
    public int onGroupMessage ( Bot bot , GroupMessageEvent event ) {
        if ( "hi" . equals ( event . getMessage ())) {
            // 构建消息
            String sendMsg = MsgUtils . builder ()
                    . at ( event . getUserId ())
                    . face ( 66 )
                    . text ( "hello, this is shiro example plugin." )
                    . build ();
            // 发送群消息
            bot . sendGroupMsg ( event . getGroupId (), sendMsg , false );
        }
        // 返回 MESSAGE_IGNORE 执行 plugin-list 下一个插件，返回 MESSAGE_BLOCK 则不执行下一个插件
        return MESSAGE_IGNORE ;
    }

}

Client

Shiro est développé avec le protocole standard OneBot-V11, qui est compatible avec tous les clients du protocole OneBot qui prennent en charge le WebSocket inversé

projet	décrire	Remarque
Llonebot	Faites de votre support NTQQ le protocole OneBot11 pour le développement de robots QQ
Lagrange.Core	Implémentation du protocole NTQQ
Go-cqhttp	Implémentation native Onebot Golang basée sur Mirai et Miraigo	Entretien de l'entretien
Openshamrock	Cadre de robot basé sur la norme OneBot basée sur Xposed

Contributeurs

Voir contribuer pour plus de détails.

Crédits

Onebot
PBBOT-Spring-Boot-Starter

Licence

Ce produit est licencié sous la version publique du GNU.

Alternativement, ce produit est compliqué sous la vie publique du GNU, 3 pour une utilisation non composée.

N'hésitez pas à nous contaler si vous avez des questions sur le liveurs ou si vous souhaitez utiliser la bibliothèque dans un produit commercial Closece.