品高聆客(Link)OpenSDK

为第三方Android应用接入Link平台提供便捷的方式，默认读者已经熟悉IDE的基本使用方法（Android Studio），以及对Link平台有一定了解，并且已经申请了对应的 ClientId 和 ClientSecret 等。

安装

在Android Studio中新建工程。在Module的build.gradle文件中，添加如下依赖：

dependencies {
    compile 'net.bingosoft.oss:linksdk:1.0.0'
}

耐心等待gradle同步完成。

使用

[1] AndroidManifest.xml 设置

添加必要的权限支持:

<!-- 网络请求权限 -->
<uses-permission android:name="android.permission.INTERNET" />

[2] 注册到Link平台

要使程序启动后Link终端能响应你的程序，必须在代码中向Link终端注册你的ClientId。这里推荐在Application级别注册（或者其他Activity级别注册），示例参考如下：

public class BaseApplication extends Application {
	//ILinkAPI是第三方app与Link通讯的openapi接口
	public ILinkAPI ilinkapi;
	publicString clientId = "linkclent66666";
    @Override
    public void onCreate() {
        super.onCreate();
		 //获取ILinkAPI实例并注册
        ilinkapi = LinkAPIFactory.createLinkAPI(this);
        ilinkapi.registerClient(clientId);
    }
}

[3] 发送请求到Link终端

现在，你的程序想要发送请求到Link终端，可以通过ILinkAPI里面的sendReq方法来实现。

void sendReq(Context context,BaseReq req);

sendReq是第三方app主动发送请求给Link终端，发送完成之后会切回到第三方app界面。

[4] 接收Link的响应结果

如果你的程序需要接收Link发送的响应结果（回调），那么需要下面3步操作：

A. 新增一个LinkEntryActivity类，该类实现ILinkAPIEventHandler接口。 图片

在AndroidManifest.xml文件中配置如下，注意action是固定不变的，用于Link终端回调找回第三方app：

<activity android:name=".LinkEntryActivity">
    <intent-filter>
       <action android:name="net.bingosoft.oss.linkauth" />
         <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

B. 实现ILinkAPIEventHandler接口，发送到Link请求的响应结果将回调到onResp方法，Link发送的请求将回调到onReq方法(暂不支持，无需实现)。

@Override
public void onReq(BaseReq req) {
	//todo 暂时不支持，无需实现
}

@Override
public void onResp(BaseResp resp) {
	//接收来自Link的回调结果
	//例如 AuthResp(继承自BaseResp)里面可以获取Link授权的结果
}

C. 在LinkEntryActivity中将接收到的intent及实现了ILinkAPIEventHandler接口的对象传递给ILinkAPI接口的handleIntent方法。需要在 onCreate和onNewIntent中实现。参考如下：

@Override
protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   setContentView(R.layout.activity_link_entry);

   app = (BaseApplication) getApplication();
   app.ilinkapi.handleIntent(getIntent(), this);
}

@Override
protected void onNewIntent(Intent intent) {
   super.onNewIntent(intent);
   app.ilinkapi.handleIntent(getIntent(), this);
}

至此，你已经能使用LinkOpenSDK的API内容了。如果想要更详细了解每个API函数的用法，请下载源码，查看里面的示例。

更多接入场景：开发者平台