关于智能家居:智汀家庭云快速入门开发第一个插件

开发您的第一个插件
此文档形容如何开发一个简略插件，面向插件开发者。

开发前先浏览插件设计概要：智汀家庭云 - 开发指南 Golang：插件模块

插件实现
获取 sdk

 go get github.com/zhiting-tech/smartassistant

定义设施

package plugin

import "github.com/zhiting-tech/smartassistant/pkg/plugin/sdk/instance"
type Device struct {
Light instance.LightBulb
Info0 instance.Info
// 依据理论设施性能组合定义
 }

func NewDevice() *Device {
return &Device{Light: instance.NewLightBulb(),
    Info0: instance.NewInfo(),}
  }

实现设施接口

package plugin

import (
"github.com/zhiting-tech/smartassistant/pkg/plugin/sdk/instance"
"github.com/zhiting-tech/smartassistant/pkg/plugin/sdk/server"
 )

type Device struct {
Light instance.LightBulb
Info0 instance.Info
// 依据理论设施性能组合定义
identity string
ch       server.WatchChan
 }

    func NewDevice() *Device {
return &Device{Light: instance.NewLightBulb(),
Info0: instance.NewInfo(),
ch:    make(server.WatchChan, 10),
}
}

  func (d *Device) Info() plugin.DeviceInfo {
 // 该办法返回设施的次要信息
return d.identity
      }
func (d *Device) Setup() error {
// 设置设施的属性和相干配置（比方设施 id、型号、厂商等，以及设施的属性更新触发函数）d.Info0.Identity.SetString("123456")
d.Info0.Model.SetString("model")
d.Info0.Manufacturer.SetString("manufacturer")

d.LightBulb.Brightness.SetRange(1, 100)
d.LightBulb.ColorTemp.SetRange(1000, 5000)
d.LightBulb.Power.SetUpdateFunc(d.update("power"))
d.LightBulb.Brightness.SetUpdateFunc(d.update("brightness"))
d.LightBulb.ColorTemp.SetUpdateFunc(d.update("color_temp"))
return nil

}

func (d *Device) Update() error {// 该办法在获取设施所有属性值时调用，通过调用 attribute.SetBool()等办法更新
d.LightBulb.Power.SetString("on")
d.LightBulb.Brightness.SetInt(100)
d.LightBulb.ColorTemp.SetInt(2000)
return nil
}

func (d *Device) Close() error {

// 自定义退出相干资源的回收

close(d.ch)
return nil
}

func (d *Device) GetChannel() plugin.WatchChan {
// 返回 WatchChan 频道，用于状态变更推送
return d.ch
}

1. 初始化和运行

 package main

 import (
"log"

"github.com/zhiting-tech/smartassistant/pkg/plugin/sdk/server"
sdk "github.com/zhiting-tech/smartassistant/pkg/server/sdk"
  )

 func main() {p := plugin.NewPluginServer("demo")
go func() {
    // 发现设施
    d := NewDevice()
    p.Manager.AddDevice(d)
}()
err := sdk.Run(p)
if err != nil {log.Panicln(err)
}
}

临时仅反对以镜像形式装置插件，调试失常后，编译成镜像提供给 SA

Dockerfile 示例参考

 FROM golang:1.16-alpine as builder
 RUN apk add build-base
 COPY . /app
 WORKDIR /app
 RUN go env -w GOPROXY="goproxy.cn,direct"
 RUN go build -ldflags="-w -s" -o demo-plugin

 FROM alpine
 WORKDIR /app
 COPY --from=builder /app/demo-plugin /app/demo-plugin

# static file
COPY ./html ./html
ENTRYPOINT ["/app/demo-plugin"]

编译镜像
docker build -f your_plugin_Dockerfile -t your_plugin_name
更多
智汀家庭云 - 开发指南 Golang：设施插件开发

demo-plugin : 通过上文的插件实现教程实现的示例插件；这是一个模仿设施写的一个简略插件服务，不依赖硬件，实现了外围插件的性能

关于智能家居:智汀家庭云快速入门开发第一个插件

2. 镜像编译和部署

3. Demo