卓影市场-手机交互支持


简介 

移动交互,主要为盒端app提供手机远程遥控的功能。


1. 功能介绍 

移动交互,可分为盒端jar包和手机遥控app两部分,提供的功能如下:


2. 兼容性
系统:支持 Android4.0(API Level 14)及以上系统。需要开发者通过minSdkVersion来保证支持系统的检测
机型:Android设备支持皆可
硬件要求:Android智能盒子、Android智能手机

3. 开发包说明
表:开发包目录结构说明

文件/文件夹名

说明

/libs

移动交互的盒端lib库,so

/demo

盒端示例程序

/mobileClient

手机端apk

移动交互开发文档

本文档





集成指南
1. 添加盒端jar包到工程
将服务端jar包添加到盒端工程中


2. 权限声明
服务端jar包需要权限如下:

名称

用途

android.permission.ACCESS_NETWORK_STATE

获取当前网络信息

android.permission.ACCESS_WIFI_STATE

获取当前WIFI网络状态

android.permission.INTERNET

允许网络连接

android.permission.CHANGE_NETWORK_STATE

允许改变网络状态

android.permission.CHANGE_WIFI_STATE

允许改变WIFI连接状态

需要在AndroidManifest.xml文件添加权限:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />





使用方法

1. 使用说明
首先保证盒端和手机端处于同一网段(同一wifi环境),才能进行通信。然后启动盒端app,并通过jar包方法创建连接,以便手机端app能够与之进行连接。启动手机端app,连接之后,便可以通过手机端app远程遥控盒端app了。



2. UDPServer
UDPServer,盒端服务器类,用于创建udp连接,接收从客户端传来的消息、并将操作命令传递给盒端app。在使用之前,先调用UDPServer .getInstance().createConnect()进行连接。
表:UDPServer说明

返回值

属性/方法说明

DatagramSocket

socket

长连接

int

MAX_CONNECT

最大连接数

List<InetAddress>

addressList

ip集合

CustomerCallBack

mCustomerCallBack

自定义回调接口

UDPServer

getInstance()

获取单例对象

void

createConnect()

创建服务端连接,进行通信之前必须先建立连接。

Void

closeConnect()

关闭服务端连接,通信结束之后关闭,避免浪费资源。



3. UDPClient
UDPClient,手机端控制类,与服务端进行通信,发送控制指令。在使用之前,先调用UDPClient .getInstance().createConnect(Context context)方法进行连接。
表:UDPClient说明

返回值

属性/方法说明

String

server_ip

服务器ip地址

DatagramSocket

socket

手机端长连接,与服务端进行通信

UDPClient

getInstance()

获取单例对象,所有对Client的操作,都是通过单例对象

void

createConnect(Context context)

创建手机端连接。在进行通信之前必须进行连接。

Void

closeConnect()

关闭手机端连接,通信结束之后关闭,避免浪费资源。

Void

sendKeyUp()

向上操作

void

sendKeyDown()

向下操作

void

sendKeyLeft()

向左操作

void

sendKeyRight()

向右操作

void

sendKeyCenter()

确定操作

void

sendKeyBack()

返回操作

void

sendKeyHome()

主页操作

void

sendMessageCallBack()

自定义回调接口的操作


4. StaticParams
StaticParams类主要存储一些静态数据。
表:StaticParams说明

返回值

属性/方法说明

String

CONNECT

与服务器连接上的标志符

String

DISCONNECT

与服务器断开连接的标志符

String

OVER_CONNECT

超出连接的标志符

String

SOFT_INPUT

软键盘输入的标志符