-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Alvin Reyes
committed
Dec 29, 2016
1 parent
d7c5b6d
commit df67741
Showing
1 changed file
with
65 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,65 @@ | ||
# Kik-BotMill | ||
A Java framework for building bots on Kik. | ||
# Kik-BotMill - Tools to Mill Kik Bots | ||
|
||
Inspired by our first ever Bot Framework [FB-BotMill](https://github.com/BotMill/fb-botmill) | ||
|
||
Kik-BotMill is designed to ease the process of developing, designing and running bots that exist inside Kik Messenger. | ||
|
||
It provides a semantic Java API that can be imported on your Java EE Project to send and receive messages from Kikso that developers can focus on developing the actual application instead of dealing with Kik API endpoints. | ||
|
||
**<h3>Getting Started</h3>** | ||
Much like how FB-BotMill can be configured, the Kik-BotMill can be imported as a dependency via Maven. | ||
|
||
<dependency> | ||
<groupId>co.aurasphere.botmill</groupId> | ||
<artifactId>kik-botmill</artifactId> | ||
<version>1.0.0</version> | ||
</dependency> | ||
|
||
Once you've imported the API. You need to register the KikBotMillServlet. To do that, create a Servlet project in your IDE and add this to your web.xml: | ||
|
||
<servlet> | ||
<servlet-name>myKikBot</servlet-name> | ||
<servlet-class>co.aurasphere.botmill.Kik.KikBotMillServlet</servlet-class> | ||
<init-param> | ||
<param-name>bot-definition-class</param-name> | ||
<param-value>com.mypackage.MyKikBotDefinitionClass</param-value> | ||
</init-param> | ||
<load-on-startup>0</load-on-startup> | ||
</servlet> | ||
<servlet-mapping> | ||
<servlet-name>myKikBot</servlet-name> | ||
<url-pattern>/myKikBot</url-pattern> | ||
</servlet-mapping> | ||
|
||
|
||
This will register a servlet named myKikBot to the path /myKikBot. The bot-definition-class parameters is a class that implements the KikBotDefinition interface or extends the AbstractKikBot class. | ||
|
||
**<h3>Creating a behaviour class</h3>** | ||
To complete your first bot, all you have to do is write the definition class. This class will describe your bot behavior. Here's an example: | ||
|
||
public class MyBotBehaviour extends AbstractKikBot { | ||
public void defineBehavior() { | ||
addActionFrame(new MessageEvent("text message"), new MessageAutoReply("simple text message")); | ||
} | ||
} | ||
|
||
The example above will basically create an event that will catch a response with text = "text message". A Reply object is then called to respond to this text message. | ||
|
||
There are several types of events and reply that can be used. | ||
|
||
**<h3>Examples</h3>** | ||
|
||
# Developing with Kik-BotMill | ||
|
||
Table of Contents | ||
* [Sending Messages](#sending-messages) | ||
* [Receiving Messages](#receiving-messages) | ||
* [Advance Topics](#advance-topics) | ||
|
||
**<h3>Sending Messages</h3>** | ||
**<h3>Receiving Messages</h3>** | ||
**<h3>Advance Topics</h3>** | ||
|
||
For more information on other callbacks, framework features or how to create a different kind of reply, check out the official wiki. | ||
|
||
<sub>Copyright (c) 2017 Donato Rimenti, Alvin Reyes</sub> |