Microgear

การเชื่อมต่อกับ NETPIE จะทำผ่านฟังก์ชั่นของ Microgear library หรือพูดอีกนัยหนึ่งก็คือ การใช้งาน NETPIE ก็คือการออกแบบสร้าง microgear ขึ้นมาทำงานร่วมกันนั่นเอง NETPIE มี microgear library หลายชนิด บนหลากหลาย hardware และหลายภาษา สำหรับ PieSketch ก็ถือเป็นอีกหนึ่ง platform ที่ NETPIE รองรับ โดย PieSketch จะมีตัวแปรชนิด Microgear ให้เรียกใช้ ซึ่งจะมาพร้อมคำสั่ง create() ดังนี้

create()

เป็นการสร้างตัวแปร microgear โดยใช้คำสั่ง create ดังนี้

Microgear.create ( key, secret, [alias] )

• key String: เป็นค่า key ที่ได้มาจากการเว็บ netpie.io
• secret String: เป็น secret ของ key ซึ่งจะใช้ประกอบในกระบวนการยืนยันตัวตน
• alias String: ชื่อเล่นของ microgear ตัวนี้ สำหรับให้ microgear อื่นอ้างอิงถึง สามารถตั้งทีหลังในโค้ดได้

ค่าที่ส่งออกมา

• microgear : ตัวแปรชนิด microgear

ตัวอย่างการใช้งาน

var microgear = Microgear.create({
        key: 'M5AT1tW3oEgilr7',
        secret: 'SenjBILrRd4a4coNX8mb9exMT',
        alias:'p5js'
});

Microgear จะส่งตัวแปร microgear ออกมา ซึ่งจะเป็น object ที่เราจะทำงานด้วย ซึ่งจะมาพร้อมฟังก์ชั่นหลักๆต่อไปนี้

• connect()
• setAlias()
• chat()
• publish()
• subscribe()
• unsubscribe()
• writeFeed()

---

connect()

การเชื่อมต่อ NETPIE จะเกิดขึ้นก็ต่อเมื่อเราสั่งให้ microgear ทำการเชื่อมต่อ โดยใช้คำสั่ง

microgear.connect ( appid )

• appid String: เป็นค่า App ID เป้าหมายที่จะเชื่อมต่อเข้าไป

ตัวอย่างการใช้งาน

microgear.connect("happyfarm");

Attention

การเชื่อมต่อ จะใช้ port 8081 และ 8084 กรุณาตรวจสอบว่าเครือข่ายของท่านอนุญาตให้ใช้งานได้

---

setAlias()

หากไม่ได้ตั้งชื่อไว้ตอนที่สร้าง เราก็ยังสามารถเปลี่ยนชื่อตัวเองได้ตลอดเวลา

microgear.connect ( alias )

• alias String: ชื่อของ microgear อันนี้

ตัวอย่างการใช้งาน

microgear.setAlias("plant");

Note

ใน App ID เดียวกัน เราสามารถตั้งชื่อ alias เดียวกันให้กับหลาย microgear พร้อมๆกันได้ และใน App ID ที่ต่างกัน ชือ alias ถึงแม้จะซ้ำกันก็จะไม่มีผลถึงกัน

---

chat()

ส่งข้อความไปยัง microgear ที่มีชื่อตามที่ระบุ

microgear.chat ( alias , message)

• alias String: ชื่อของ microgear อันนี้
• message String|Number|Object: ข้อความที่จะส่งไป

ตัวอย่างการใช้งาน

microgear.chat("valve","I need water");

---

publish()

ในการณีที่ต้องการส่งข้อความแบบไม่เจาะจงผู้รับ สามารถใช้ฟังชั่น publish ไปยัง topic ที่กำหนดได้ ซึ่งจะมีแต่ microgear ที่ subscribe topoic นี้เท่านั้น ที่จะได้รับข้อความ

ส่งข้อความไปยัง microgear ที่มีชื่อตามที่ระบุ

microgear.publish ( topic , message )

• alias String: ชื่อของ topic ที่ต้องการจะส่งข้อความไปถึง
• message String|Number|Object: ข้อความที่จะส่งไป

ตัวอย่างการใช้งาน

microgear.publish("/outdoor/temp","28.5");

---

subscribe()

microgear อาจจะมีความสนใจใน topic ใดเป็นการเฉพาะ เราสามารถใช้ฟังก์ชั่น subscribe() ในการบอกรับ message ของ topic นั้นได้

microgear.subscribe ( topic )

• alias String: ชื่อของ topic ที่สนใจต้องการรับข้อความ

ตัวอย่างการใช้งาน

microgear.subscribe("/outdoor/temp");

Note

นอกจากการระบุ topic เป็น string แบบชัดเจนแล้ว เรายังสามารถใช้สัญลักษณ์ wildcard เครื่องหมาย # และ * ได้ด้วย ศึกษาเพิ่มเติมได้ที่นี่ [wildcard]

---

unsubscribe()

ยกเลิกการ subscribe

microgear.subscribe ( topic )

• alias String: ชื่อของ topic ที่สนใจต้องการยกเลิกการรับข้อความ

ตัวอย่างการใช้งาน

microgear.unsubscribe("/outdoor/temp");

---

writeFeed()

เขียนข้อมูลลง feed storage

microgear.subscribe ( topic )

• feedid String: ชื่อของ feed ที่ต้องการจะเขียนข้อมูล
• datajson String: ข้อมูลที่จะบันทึก ในรูปแบบ json
• apikey String: apikey สำหรับตรวจสอบสิทธิ์ หากไม่กำหนด จะใช้ default apikey ของ feed ที่ให้สิทธิ์ไว้กับ AppID

ตัวอย่างการใช้งาน

microgear.writeFeed("homesensor",{temp:25.7,humid:62.8,light:8.5});

---