Android平台WebSocket插件使用说明

1. 安装指南

1.1 Native Android 使用方式

1. 将Java源文件复制到您的源文件夹中。
2. 创建一个类（例如WebSocketListener），继承自WebSocket（参考：com.strumsoft.websocket.WebSocket）。
3. 实现以下方法：
   • onOpen：连接打开时调用。
   • onClose：连接关闭时调用。
   • onMessage：接收到消息时调用。
   • onReconnect：连接失败时尝试重新连接到服务器。

1.2 Phonegap 使用方式

1. 将Java源文件复制到您的源文件夹中。
2. 将websocket.js文件复制到assets/www/js文件夹中。
3. 在WebView中附加com.strumsoft.websocket.phonegap.WebSocketFactory，如下所示：

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    super.loadUrl("file:///android_asset/www/index.html");

    // 附加WebSocket工厂
    appView.addJavascriptInterface(new WebSocketFactory(appView), "WebSocketFactory");
}

2. 项目的使用说明

2.1 Native Android 使用说明

将Java源文件加入项目，并根据需要实现对应的回调方法。

2.2 Phonegap 使用说明

在页面中创建一个新的WebSocket，并重写onopen、onmessage、onclose方法，如下所示：

// 创建新socket
var socket = new WebSocket('ws://192.168.1.153:8081');

// 连接建立后发送消息
socket.onopen = function() {
    socket.send('{ "type": "join", "game_id": "game/6"}');
};

// 接收服务器推送的消息
socket.onmessage = function(msg) {
    alert(JSON.stringify(msg.data));
};

// 连接关闭事件
socket.onclose = function() {
    alert('closed');
};

3. 项目API使用文档

本项目为Android平台实现了WebSocket API（Draft-75/76）。使用java.nio.*包来实现高效的非阻塞事件驱动行为。本项目易于与Phonegap框架集成。

4. 项目安装方式

请参考安装指南中提供的步骤进行安装。根据您的项目需求选择Native Android或Phonegap的集成方式。

注意：本项目目前不支持WebSocket API定义的onerror事件和各种状态。作者正在努力开发中。如果您喜欢这个项目，欢迎加入开发团队。