如何实现，基于 PaaS 平台 OpenAPI & App SDK的照明系统开发？附代码段讲解

Posted 2021-12-04 IoT砖家涂拉拉

您是否在寻找智能化、多样化、个性化、场景化以及节能环保的智能照明解决方案呢？

涂鸦智慧商用照明 SaaS 依托于 IoT，适用于商用场景下，对大型空间中大量设备进行快速集智控制，可针对用户照明应用场景的专业需求，提供多样化的设备控制策略，以实现照明系统智能化运营和管理的同时有效降低其能耗。帮助客户实现商业智能化，降低管理成本。

涂鸦IoT PaaS + Web & App & 小程序, 支持OEM

商照 SaaS 管理系统搭配集智光控 App 和 小程序，在多终端上连接设备和涂鸦IoT PaaS，集设备施工、资产管理、自动化控制、智能规则和数据统计等能力于一体，帮助实现照明系统智能化。

我们提供了丰富而有特色的功能集，完整的功能列表请参见官网功能清单：

• 设备施工：创建任务、一键授权，将配网交给专业人士，将设备留给自己。

• 资产管理：项目、空间、设备，多层次的管理，让您的系统一切尽在掌握之中。

• 设备控制：Web + App + 小程序，多端自动化控制，单控、多控、群组，不同的维度，从小控到大，一个不落。

• 智能规则：场景、自动化、日程，加上自定义模板，让设备像演员，而您是导演。

• 数据统计：数据大屏，能耗分析，让您眼里有数，心里也有数。

自定义开发：基于 PaaS 平台 OpenAPI & App SDK

为了满足用户个性化定制的需求，我们通过 PaaS 平台，提供 OpenAPI 和移动端 SDK，帮助用户快速搭建独属于自己的 SaaS 系统，实现品牌效应最大化。用户也可以对接自己现有的系统，提升系统的自动化水平。如果您具备一定规模，拥有自己的研发团队，期望搭建专属的系统，我们推荐您使用本方式。

 典型应用场景与落地效果 

• 停车场照明解决方案

停车场灯具可根据车辆、人员存在情况，自动进行开启和关闭。保证车库安全照明的同时实现节能。（更多详情可见）

• 教室照明解决方案

照明设备根据自动化场景和环境条件，可自动调节到人体舒适的照度；提供设备信息数字化、大屏可视化的展示。（更多详情可访问）

• 商店照明解决方案

根据时间段、人群、区域的不同，系统提供不同以人为本的照明策略，引导用户的购买行为。（更多详情可访问）

我们通过以下简易流程，帮助您理解基于 PaaS 平台个性化开发的过程和可拥有的功能。

 1.首先通过项目管理的 OpenAPI 创建项目，通过空间管理的 OpenAPI 创建空间，您可以对项目和空间进行权限管理。

// 创建项目（以下代码仅在使用 Java SDK 作为参考，调用方式大同小异，在后续步骤中将省略非关键代码）
ProjectCreateRequest request = new ProjectCreateRequest();
request.setName("Project Name");
request.setLeaderMobile("1995421****");
request.setLeaderName("no one");
request.setAddress("hangzhou");
request.setDetail("detail address");
request.setLongitude(1.01);
request.setLatitude(2.01);
BaseResponse<ProjectCreateResult> response = projectApi.create(request);
// 创建空间
RoomCreateRequest request = new RoomCreateRequest();
// 省略非关键代码……
BaseResponse<RoomCreateResult> response = roomApi.create(request);

2.通过App SDK完成设备配网后（可先用集智光控App代替），可以通过设备管理和设备控制 OpenAPI 对设备下发操作指令。

// 省略非关键代码……
// 查询设备列表
DeviceListRequest request = new DeviceListRequest();
BaseResponse<PageResult<DeviceDetailResult>> response = deviceApi.listDevices(request);
// 控制单个设备
DeviceSingleControlRequest request = new DeviceSingleControlRequest();
BaseResponse<DeviceControlResult> response = deviceApi.singleControl("*****1632901862*****", request);

devices_monitor

3.在简单的设备控制外，我们提供高级的智能规则 OpenAPI，可基于空间、时间和设备状态等条件创建自动化控制策略。

// 基于空间条件创建智能规则（场景类型）
BaseResponse<SceneSaveResult> response = sceneApi.create(request);
// 基于时间条件创建智能规则（日程类型）
BaseResponse<LinkageInfoResult> response = linkageApi.createSchedule(request);
// 基于设备状态条件创建智能规则（联动类型）
BaseResponse<LinkageInfoResult> response = linkageApi.createLinkage(request);

smart_rules

4.您还可以通过数据统计 OpenAPI 查询设备的能耗数据，搭建数据大盘进行相关分析。

// 按日、月、年进行空间能耗查询
BaseResponse<EnergyStatisticsResult> response = energyStatisticsApi.query(request);

data_statics

使用 Java SDK 对接 OpenAPI

为了用户方便地接入 OpenAPI，专注于业务层的逻辑实现，我们提供了 Java SDK 供用户参照和使用。

1.下载 jar 包引入依赖

<dependency>
    <groupId>com.tuya</groupId>
    <artifactId>tuya-lighting-open-api-java-sdk</artifactId>
    <version>1.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/tuya-lighting-open-api-java-sdk-1.0.jar</systemPath>
</dependency>

2.创建各功能的 API 服务实例进行使用。

publicclass DemoApplication {

    public static void main(String[] args) {
        // 配置调用OpenAPI的client_id和client_secret
        TuyaOpenApiConfiguration tuyaOpenApiConfiguration = new TuyaOpenApiConfiguration();
        tuyaOpenApiConfiguration.setUrl("https://openapi.tuyacn.com");
        tuyaOpenApiConfiguration.setClientId("******swael9wq******");
        tuyaOpenApiConfiguration.setClientSecret("******9f429248caab6017554f******");
        HttpClientUtils.setTuyaOpenApiConfiguration(tuyaOpenApiConfiguration);
        // 创建各功能的API服务的实例
        ProjectApi projectApi = new ProjectApi();
        TokenApi tokenApi = new TokenApi();
        // 获取access_token，并设置到请求的上下文中
        BaseResponse<TokenResult> accessToken = tokenApi.getAccessToken(1);
        HttpClientUtils.setTokenResult(accessToken.getResult());
        // 请求各功能相关的OpenAPI，如查询项目列表
        BaseResponse<PageResult<ProjectListItem>> response = projectApi.page(1, 10, null);
    }
}

涂鸦智慧商用照明 PaaS 完整的对接文档请参见官方文档涂鸦商用照明 OpenAPI 对接。

最后

涂鸦商照通过商用照明软件+精选涂鸦生态设备，形成软硬件组合，为用户提供“针对各个照明应用场景的快速落地方案”。依靠数年以来，各行业丰富的解决方案的经验积累，我们逐渐沉淀出通用的 PaaS 能力，让您可以通过 OpenAPI 定制专属自己的系统。为全球的照明品牌赋能 AIoT，是我们的使命，也是我们的愿景，期待您的加入，一同进步。

【提交开通商照账号申请】

【进一步的平台接入帮助文档或项目需求】