allthingstalk / go-sdk Goto Github PK

Currently all publish and subscribe operations are going though Device API (e.g. device.Publish(...)).

We can introduce the following to enhance it:

• asset.Publish(state)
• asset.Subscribe(chan command)

AllThingsTalk supports sending multiple asset states in one message, which makes sense when trying to preserve bandwidth and ensure all states are set in one go.

Proposal:

• device.PublishStates(...) should accept a list of states. In the background, this could either translate to sending one device state message or multiple asset states message. Former is by default. It should also be possible to define custom payload format as well (for ABCL).

• Custom payload formats may be defined with abcl struct tag (depengind on how ABCL is promoted).

• We could also support builders to bundle asset states and send them all in one go.

• Device should have additional encoding configuration option which can be used to specify the encoding - if necessary user choose choose between JSON, CBOR or custom binary format. (?)

• Prepare API proposal for Binary payload

• Prepare API proposal for Device State

• Review

Any changes to Readme file trigger TravisCI build. We should add it to the ignore list in order not to rebuild each time docs change, as we currently can't run examples found in Readme file.