资产服务

更新时间:2024-05-17 03:12:13下载pdf

资产服务提供资产的基本操作,以及获取资产下设备信息等能力。

通过 IUser.getSpaceType(),判断当前空间体系是否为资产体系。1 表示空间体系,2 表示资产体系。

常见属性解释

IAsset 接口

接口 说明
getAssetId(): String 资产的唯一标识符
getAssetName(): String 资产名称
getParentAssetId(): String 父级资产的唯一标识符
getPermission(): String 资产权限
  • all:拥有资产的所有权限
  • read:拥有资产的只读权限
getCurrentSubAssetNum(): Int 子资产数量
getCurrentAssetDeviceNum(): Int 资产下设备数量
getUserDefinedPath(): String 资产路径

IAssetDeviceListResult 接口

接口 说明
getDevices(): List 设备列表
getHasMore(): Boolean 是否有更多设备
getLastRowKey(): String 最后一行的 RowKey,用于分页查询

IAssetDevice 接口

接口 说明
getDeviceId(): String 设备 ID
getDeviceName(): String 设备名称
isOnline(): Boolean 设备是否在线,指局域网或者云端在线
getIcon(): String 设备图片
getActiveTime(): Long 设备激活时间戳
getAssetId(): String 资产 ID
getCategoryName(): String 品类名称
getCategory(): String 品类 Code
getIsGateWay(): Boolean 是否为网关设备
getSub(): Boolean 是否有子设备
getProductName(): String 产品名称
getTimeZone(): String 设备所在时区

IDeviceStatistic 接口

接口 说明
getStatisticType(): String 统计类型
getTotal(): Long 设备总数
getTypeValue(): String 统计类型显示文案

新增资产

参数说明

参数名 类型 是否必填 说明
name String 要创建的名称
parentAssetId String 父资产的 ID
callback IndustryCallBack 回调函数

代码示例

AssetService.create("name", "parentAssetId", new IndustryCallBack() {
            @Override
            public void onSuccess() {
                Log.d(TAG, "onSuccess: ");
            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

修改资产名称

参数说明

参数名 类型 是否必填 说明
assetId String 要修改的资产的 ID
name String 修改后的名称
callback IndustryCallBack 回调函数

代码示例

AssetService.update("assetId", "name", new IndustryCallBack() {
            @Override
            public void onSuccess() {
                Log.d(TAG, "onSuccess: ");

            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

删除资产

参数说明

参数名 类型 是否必填 说明
assetId String 要删除的资产的 ID
callback IndustryCallBack 回调函数

代码示例

AssetService.remove("assetId", new IndustryCallBack() {
            @Override
            public void onSuccess() {
                Log.d(TAG, "onSuccess: ");

            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

获取单个资产属性

参数说明

参数名 类型 是否必填 说明
assetId String 要查询的资产的 ID
callback IndustryValueCallBack 回调函数

代码示例

AssetService.asset("assetId", new IndustryValueCallBack<IAsset>() {
            @Override
            public void onSuccess(IAsset iAsset) {
                Log.d(TAG, "onSuccess: ");
            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

获取子资产属性列表

参数说明

参数名 类型 是否必填 说明
assetId String? 要查询的资产的 ID。如果为 nil,则查询所有子资产
callback IndustryValueCallBack<List> 回调函数,返回查询到的子资产列表

代码示例

AssetService.subAssets("assetId", new IndustryValueCallBack<List<IAsset>>() {
            @Override
            public void onSuccess(List<IAsset> iAssets) {
                Log.d(TAG, "onSuccess: ");

            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

获取设备统计列表

参数说明

参数名 类型 是否必填 说明
assetId String 要查询的资产的 ID
callback IndustryValueCallBack<List> 回调函数,返回设备统计列表

代码示例

AssetService.statistics("assetId", new IndustryValueCallBack<List<IDeviceStatistic>>() {
            @Override
            public void onSuccess(List<IDeviceStatistic> result) {
                Log.d(TAG, "onSuccess: ");
            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

获取设备列表

参数说明

参数名 类型 是否必填 说明
assetId String 要查询的资产的 ID
lastRowKey String? 上一次查询返回的最后一行的 RowKey,用于分页查询
callback IndustryValueCallBack 回调函数,返回查询到的设备列表

代码示例

AssetService.devices("assetId", "lastRowKey", new IndustryValueCallBack<IAssetDeviceListResult>() {
            @Override
            public void onSuccess(IAssetDeviceListResult iAssetDeviceListResult) {
                Log.d(TAG, "onSuccess: ");
            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

参数说明

参数名 类型 是否必填 说明
assetId String 要查询的资产的 ID
statisticsType String 统计类型,IDeviceStatistic.getStatisticType
lastRowKey String? 上一次查询返回的最后一行的 RowKey,用于分页查询
pageSize Int 分页数量
callback IndustryValueCallBack 回调函数,返回查询到的设备列表

代码示例

AssetService.devices("assetId", null, 20, "lastRowKey", new IndustryValueCallBack<IAssetDeviceListResult>() {
            @Override
            public void onSuccess(IAssetDeviceListResult iAssetDeviceListResult) {
                Log.d(TAG, "onSuccess: ");
            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

查询设备列表

参数说明

参数名 类型 是否必填 说明
assetId String 要查询的资产的 ID
lastRowKey String? 上一次查询返回的最后一行的 RowKey,用于分页查询
deviceName String 设备名称
pageSize Int 分页数量
callback IndustryValueCallBack 回调函数,返回查询到的设备列表

代码示例

AssetService.search("assetId", "灯", 20, "lastRowKey", new IndustryValueCallBack<IAssetDeviceListResult>() {
            @Override
            public void onSuccess(IAssetDeviceListResult iAssetDeviceListResult) {
                Log.d(TAG, "onSuccess: ");
            }

            @Override
            public void onError(int i, String s) {
                Log.d(TAG, "onError: ");

            }
        });

获取单个资产管理实例

参数说明

参数名 类型 是否必填 说明
assetId String 要查询的资产的 ID

代码示例

IAssetManager manager = AssetService.assetManager("assetId");