智能小程序开发 —— P2P SDK 源码介绍(二)

本文介绍了P2PKit库中的四个主要功能:文件上传、下载、取消任务以及查询文件索引,展示了如何在不同设备间进行文件操作,并提供了相应的接口和回调机制。

ty.p2p.uploadFile

P2P上传文件

需引入P2PKit,且在>=0.0.1版本才可使用

参数

Object object

属性类型默认值必填说明
deviceIdstring设备id
albumNamestringalbumName 和设备端约定字段
filePathstring文件本地路径
extDatastring扩展字段
extDataLengthnumber扩展字段长度
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * P2P上传文件
 */
export function uploadFile(params: {
  /** 设备id */
  deviceId: string
  /** albumName 和设备端约定字段 */
  albumName: string
  /** 文件本地路径 */
  filePath: string
  /** 扩展字段 */
  extData?: string
  /** 扩展字段长度 */
  extDataLength?: number
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

 👉 立即开发

ty.p2p.cancelUploadTask

取消传输任务

需引入P2PKit,且在>=0.0.1版本才可使用

参数

Object object

属性类型默认值必填说明
deviceIdstring设备id
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * 取消传输任务
 */
export function cancelUploadTask(params: {
  /** 设备id */
  deviceId: string
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

ty.p2p.downloadFile

P2P下载文件

需引入P2PKit,且在>=2.0.3版本才可使用

参数

Object object

属性类型默认值必填说明
deviceIdstring设备id
albumNamestringalbumName 和设备端约定字段
filePathstring下载文件本地存储路径
jsonfilesstring下载的文件名称,eg: {"files":["filesname1", "filesname2", "filesname3" ]}
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * P2P下载文件
 */
export function downloadFile(params: {
  /** 设备id */
  deviceId: string
  /** albumName 和设备端约定字段 */
  albumName: string
  /** 下载文件本地存储路径 */
  filePath: string
  /** 下载的文件名称,eg: {"files":["filesname1", "filesname2", "filesname3" ]} */
  jsonfiles: string
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

ty.p2p.cancelDownloadTask

取消下载任务

需引入P2PKit,且在>=2.0.3版本才可使用

参数

Object object

属性类型默认值必填说明
deviceIdstring设备id
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * 取消下载任务
 */
export function cancelDownloadTask(params: {
  /** 设备id */
  deviceId: string
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

ty.p2p.downloadStream

P2P下载数据流

需引入P2PKit,且在>=2.0.3版本才可使用

参数

Object object

属性类型默认值必填说明
deviceIdstring设备id
albumNamestringalbumName 和设备端约定字段
jsonfilesstring下载的文件名称,eg: {"files":["filesname1", "filesname2", "filesname3" ]}
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * P2P下载数据流
 */
export function downloadStream(params: {
  /** 设备id */
  deviceId: string
  /** albumName 和设备端约定字段 */
  albumName: string
  /** 下载的文件名称,eg: {"files":["filesname1", "filesname2", "filesname3" ]} */
  jsonfiles: string
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

ty.p2p.queryAlbumFileIndexs

查询设备相册文件索引列表

需引入P2PKit,且在>=2.0.3版本才可使用

参数

Object object

属性类型默认值必填说明
deviceIdstring设备id
albumNamestringalbumName 和设备端约定字段
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

object.success回调参数

参数

Object res

属性类型说明
countnumber文件个数
itemsarray文件索引

object.fail回调参数

参数

Object res

属性类型说明
errorMsgstring插件错误信息
errorCodestring错误码
innerErrorobject插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 查询设备相册文件索引列表
 */
export function queryAlbumFileIndexs(params: {
  /** 设备id */
  deviceId: string
  /** albumName 和设备端约定字段 */
  albumName: string
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: {
    /** 文件个数 */
    count: number
    /** 文件索引 */
    items: ThingP2PAlbumFileIndex[]
  }) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

👉 立即开发

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

IoT砖家涂拉拉

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值