peyman/bale-sdk

1.0.0 2019-01-27 06:49 UTC

This package is auto-updated.

Last update: 2024-09-19 00:47:03 UTC


README

Bale-SDK

用于与贝莱特机器人通信的库

此库仅用于向贝莱特聊天机器人发送各种消息到频道或用户。

首先,您需要获取此库

composer require peyman/bale-sdk

好了,您成功了

为了发送消息,您首先需要获取频道或用户的标识符。为此,您应该使用以下方法

说明:您首先需要在频道中添加已创建的机器人,但不要将其设置为管理员。

require "../vendor/autoload.php";

/**
 *  SET YOUR TOKEN FOR USE SEND MESSAGE TYPES
 */
$Bale = new \Vicente\Bale\Bale("YOUR TOKEN");

/**
 * hears GET TYPE AND USER ID AND ACCESS HASH
 */
$Bale->hears(function($user){
	print_r($user);
});

执行上述代码后,您将收到一个包含以下三个值的JSON对象。

  • id // 频道或用户标识符
  • accessHash // 频道或用户的专用访问代码
  • type

说明

在获取上述信息后,您需要将加入频道的机器人设置为管理员。在上面的type部分,您要发送到频道时应使用Group类型,发送到用户时应使用User类型。

好了,在获取上述信息后,您可以使用以下代码发送文本消息。

require "../vendor/autoload.php";

/**
 *  SET YOUR TOKEN FOR USE SEND MESSAGE TYPES
 *
 *  $property string YOUR TOKEN
 */
$Bale = new \Vicente\Bale\Bale("YOUR TOKEN");

/**
 *  SET TYPE USER AND ID USER AND ACCESS HASH
 *
 *  $property array TYPE  [Group,User]
 *  $property string ID   (user_id get from method hears)
 */
$peerUser = new \Vicente\Bale\Peer\PeerUsers("TYPE","ID","ACCESS HASH");

/**
 *  GET PARAMS FOR SEND TEXT MESSAGE
 *
 *  $property string YOUR MESSAGE
 */
$textMessage = new \Vicente\Bale\Message\TextMessage('YOUR MESSAGE');

try {

	/**
	 * send METHOD FOR SEND TYPES OF MESSAGE
	 */
	$send = $Bale->send( $textMessage, $peerUser->getPeer() );

} catch ( \Vicente\Bale\Exception\MessageException $e ) {

	return "SERVER ERROR";

}

说明:在上面的示例中,使用从hears方法获取的值填充peerUsers。

要发送文件或图片,请使用以下代码。

require "../vendor/autoload.php";

/**
 *  SET YOUR TOKEN FOR USE SEND MESSAGE TYPES
 */
$Bale = new \Vicente\Bale\Bale("YOUR TOKEN");

/**
 *  SET TYPE USER AND ID USER AND ACCESS HASH
 */
$peerUser = new \Vicente\Bale\Peer\PeerUsers("Group","1661462554","-2072671474748044026");

/**
 * NEW FILE CLASS FOR SEND FILE OR IMAGE
 */
$file = new \Vicente\Bale\Message\FileMessage();

/**
 * sendFiles IS METHOD GET PARAMS FOR USE SEND FILE OR IMAGE
 */
$fileMessage = $file->sendFiles("PATH OF YOUR IMAGE OR YOUR FILE",function ($params) use($Bale,$peerUser){

	/**
	 * send METHOD FOR SEND TYPES OF MESSAGE
	 */
	$Bale->send($params,$peerUser->getPeer());


},"MESSAGE FOR SEND WITH FILE OR IMAGE");