扫地机 P2P

更新时间:2024-05-10 05:46:37下载pdf

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

扫地机 P2P 功能是基于垂直品类 IPC 的 P2P 能力开发,所以接入扫地机 P2P 库时,您需要同时接入涂鸦 P2P SDK 的最新版本。

功能入口

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 数据失败回调
            }
            });

请勿在该回调的 onFailure 里面调用 thingSweeperP2P.onDestroyP2P();

关闭 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 下载失败回调
            }
            });

请勿在该回调的 onFailure 里面调用 thingSweeperP2P.onDestroyP2P();

查询 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 错误码

常见问题

  • 问题现象SweeperP2PCallbackSweeperP2PCallback 类标红,提示找不到,找到依赖库的 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