开发指南

SDK开发指南

产品使用指南

Android SDK

Android SDK 开发指南

1. 概述

开发者集成 SDK 到其应用里，为 App 提供和Geelinked模块通讯的能力。
当开发者想要和Geelinked模块实时通讯的时候，只需要调用API发送消息和设置回调函数接收数据。
SDK一共4个API函数，集成简单，使用方便。

2. SDK下载

项目	下载地址
Android Demo (源码)`已包含SDK`	电信联通
Android SDK	电信联通
Android Demo (APK)	电信联通

3. API调用流程

3.1 Import

import com.geelinked.sdk.geenet.*;

3.2 准备工作

获取SDK对象

getInstance
设置SDK账号

serUserInfo

设置接收数据的回调函数

setCallback

3.3 通讯

发送数据

sendData
sendDataT

接收数据 - 通过回调函数接收

GeenetCallback

4. Android DEMO

DEMO 界面

Demo_CSharp

操作步骤

在界面上方点登录SDK账号, 填入SDK账号, 密码, 点击OK。
在请输入接收模块ID 输入接收数据的模块ID, 在请输入发送数据 内输入要发送的数据, 点击send按钮即可发送。
在数据接收区框内显示模块ID发送来的数据。

5. API Doc

Class

com.geelinked.sdk.geenet
GeenetSDK

Function: getInstance - 获取SDK对象

函数原型

public static GeenetSDK getInstance()

函数说明

GeenetSDK 是一个单例类，通过getInstance该函数获取该类的唯一对象。通过该对象调用API函数。

返回值

返回GeenetSDK的唯一对象

代码示例

GeenetSDK msdk = GeenetSDK.getInstance();

Function: serUserInfo - 设置SDK账号

函数原型

public boolean serUserInfo(String sdkid, String password)

参数

参数	描述
sdkid	传入SDK账号的ID `5开头的11位数字ID`
password	传入SDK账号的密码

返回值

返回值	描述
-1	失败
0	成功 `此处仅为设置，ID和密码在发送数据时才会去校验`

代码示例

GeenetSDK msdk = GeenetSDK.getInstance();  
boolean ret = msdk.serUserInfo("5378878****", "123456");

Function: setCallback - 设置接收数据的回调函数

函数原型

public void setCallback(GeenetCallback pcallback)

参数

参数	描述
GeenetCallback	1.实现GeenetCallback接口, 并传入该对象. Interface GeenetCallback

返回值

返回值	描述
void	void

代码示例

public class MainActivity extends AppCompatActivity implements GeenetCallback {
	......
	@Override
	public void ReceiveData(String senderId, byte[] data_buffer, int data_len) {
		//实现GeenetCallback接口函数
		......
	}
	......
	msdk = GeenetSDK.getInstance();
	msdk.setCallback(this);
	......

Function: sendDataT - 发送数据(有返回值)

函数原型

public int sendDataT(byte[] data, int data_len, String str_dst_userid)

参数

参数	描述
data	[in]要发送的数据
data_len	[in]数据的长度
str_dst_userid	[in]模块ID`指定要把数据发送给那个模块`

返回值

返回值	描述
0	成功,数据已加入发送队列
10	服务器连接中断
11	被连接方不在线
12	没有权限和对方通信，通信双方必须在一个组
13	连接已过期
14	发送数据超时，请重新发送数据
15	和接收方连线超时，请重新发送数据
20	发送的数据不正确
23	接收方不在线或没有权限和对方通信
-1	其它

代码示例

String vdatastr = "Hello,World!";
byte[] vdata = vdatastr.getBytes("gbk");
int ret = msdk.sendDataT(vdata, vdata.length, "9056840****");

发送数据(无返回值) ： sendData

函数原型

public void sendData(byte[] data, int data_len, String str_dst_userid)

参数

参数	描述
data	[in]要发送的数据
data_len	[in]数据的长度
dst_userid	[in]模块ID`指定要把数据发送给那个模块`

返回值

返回值	描述
void	void

代码示例

String vdatastr = "Hello,World!";
byte[] vdata = vdatastr.getBytes("gbk");
msdk.sendData(vdata, vdata.length, "9056840****");

Interface

com.geelinked.sdk.geenet
GeenetCallback

Function: ReceiveData - 接收数据回调函数

函数原型

public void ReceiveData(String sender_Id, byte[] data_buffer, int data_len)

参数

参数	描述
sender_Id	[out]发送数据的ID`模块ID`、`SDK账号ID`
data_buffer	[out]接收的数据
data_len	[out]数据的长度

返回值

返回值	描述
void	void

代码示例

public class MainActivity extends AppCompatActivity implements GeenetCallback {
	......
	@Override
	public void ReceiveData(String senderId, byte[] data_buffer, int data_len) {
		//实现GeenetCallback接口函数
		......
	}
	......
	msdk = GeenetSDK.getInstance();
	msdk.setCallback(this);
	......