扫地机 P2P

扫地机 Peer-to-Peer（P2P）能力提供 P2P 下载通道，来获取扫地机上的地图和清扫路线数据。由于数据直接来源于设备点对点的直传，所以无需将实时地图与数据上传至云存储服务器再下载，从而达到数据传输速度更快、更节省云存储成本的目的。

功能入口

IThingSweeperKitSdk iThingSweeperKitSdk = ThingOptimusSdk.getManager(IThingSweeperKitSdk.class);

IThingSweeperP2P thingSweeperP2P = iThingSweeperKitSdk.getSweeperP2PInstance(devId);

连接 P2P 服务

接口说明

/**
*
* @param callback  P2P 连接回调
*/
void connectDeviceByP2P( SweeperP2PCallback callback);

参数说明

参数	说明
callback	连接 P2P 数据下载回调

代码示例

thingSweeperP2P.connectDeviceByP2P(new SweeperP2PCallback() {
    @Override
    public void onSuccess() {
            //成功回调
            }

    @Override
    public void onFailure(int i) {
            //失败回调
            }
            });

开启 P2P 数据下载

接口说明

保证在 connectDeviceByP2P 回调成功后，开启文件传输。传输过程中发生通道异常断开时，会有 failure 的错误回调，回调错误码可参考末尾错误码。如果发生错误回调，说明设备可能出现网络异常，可重新调用 connectDeviceByP2P 接口尝试重连设备。

/**
*
* @param downloadType     下载数据方式
* @param callback         开启 P2P 数据下载回调
* @param callback2        P2P 数据回调
*/
void startObserverSweeperDataByP2P(DownloadType downloadType, SweeperP2PCallback callback, SweeperP2PDataCallback callback2);

参数说明

参数	说明
downloadType	P2P 数据交换方式。 DownloadType.P2PDownloadTypeOnce：下载完当前设备的数据，就会停止后续产生数据的下载。 DownloadType.P2PDownloadTypeStill：持续下载设备产生的数据，直到设备自动停止发送数据。
callback	开启 P2P 数据下载回调。
callback2	P2P 数据接收回调。

SweeperP2PBean 说明

参数	说明
type	数据类型。 0：地图数据 1：清扫路径数据 3：导航路径数据 -1：错误数据
data	P2P 数据。

代码示例

thingSweeperP2P.startObserverSweeperDataByP2P(DownloadType.P2PDownloadTypeOnce, new SweeperP2PCallback() {
    @Override
    public void onSuccess() {
            //开启 P2P 下载成功回调
            }

    @Override
    public void onFailure(int i) {
            //开启 P2P 下载失败回调
            }
            }, new SweeperP2PDataCallback() {
    @Override
    public void receiveData(int type, @Nullable SweeperP2PBean sweeperP2PBean) {
            //接受 P2P 数据回调，type 表示接收到的数据类型
            }

    @Override
    public void onFailure(int i) {
            //接受 P2P 数据失败回调
            }
            });

关闭 P2P 数据下载

暂停 P2P 数据传输，不断开 P2P 通道，可重新使用 startObserverSweeperDataByP2P 接口继续下载。

/**
*
* @param callback         关闭 P2P 数据下载回调
*/
void stopObserverSweeperDataByP2P(SweeperP2PCallback callback);

参数说明

参数	说明
callback	关闭 P2P 数据下载回调

代码示例

thingSweeperP2P.stopObserverSweeperDataByP2P(new SweeperP2PCallback() {
    @Override
    public void onSuccess() {
            //关闭 P2P 下载成功回调
            }

    @Override
    public void onFailure(int i) {
            //关闭 P2P 下载失败回调
            }
            });

查询 P2P 连接状态

/**
* 检查 P2P 的连接状态
*/
boolan checkP2PActive();

代码示例

thingSweeperP2P.checkP2PActive();

关闭 P2P 服务

停止下载，并销毁通道，释放占用的内存资源和线程资源。

/**
*
* @param callback         关闭 P2P 数据下载回调
*/
void onDestroyP2P();

代码示例

thingSweeperP2P.onDestroyP2P();

停止 P2P 重连机制

当在前台会话断开，和在后台会话断开进入前台时，P2P SDK 会进行自动重连。您可以调用此方法停止自动重连，由外部控制重连时机。

/**
* 停止内部重连机制，默认 false
* @param isStopReconnect 是否停止重连
*/
void stopReconnect(boolean isStopReconnect);

代码示例

thingSweeperP2P.stopReconnect(true);

错误码

错误码	说明
-9000	deviceBean 丢失
-9001	未集成 P2P SDK
-9002	正在连接 P2P
-9003	设备离线
-9004	超时
-9005	无地图文件
-9006	P2P 连接断开

更多错误码，参考垂直品类 IPC SDK 错误码。

常见问题

• 问题现象：SweeperP2PCallback 或 SweeperP2PCallback 类标红，提示找不到，找到依赖库的 arr，但提示类似于：

  // This class file was compiled with different version of Kotlin compiler and can't be decompiled.
  // Current compiler ABI version is 1.1.16
  // File ABI version is 1.5.1
  

• 解决方法：可以尝试更新 Android Studio 内的 Kotlin 版本。更新路径为 Preferences > Languages & Framework > Kotlin。