@@ -33,9 +33,9 @@ const char* ssid = <WIFI_SSID>;
3333const char * password = <WIFI_KEY>;
3434
3535#define APPID <APPID>
36- #define GEARKEY <APPKEY>
37- #define GEARSECRET <APPSECRET >
38- #define SCOPE ""
36+ #define KEY <APPKEY>
37+ #define SECRET <APPSECRET >
38+ #define ALIAS "myplant "
3939
4040WiFiClient client;
4141AuthClient *authclient;
@@ -90,9 +90,7 @@ void setup() {
9090 Serial.println("IP address: ");
9191 Serial.println(WiFi.localIP());
9292
93- //uncomment the line below if you want to reset token -->
94- //microgear.resetToken();
95- microgear.init(GEARKEY,GEARSECRET,SCOPE);
93+ microgear.init(KEY,SECRET,ALIAS);
9694 microgear.connect(APPID);
9795 }
9896}
@@ -121,22 +119,15 @@ void loop() {
121119```
122120## การใช้งาน library
123121---
124- **microgear.init (*gearkey*, *gearsecret*, *scope *)**
122+ **microgear.init (*gearkey*, *gearsecret*, *alias *)**
125123
126124**arguments**
127- * *gearkey* `string` - เป็น key สำหรับ gear ที่จะรัน ใช้ในการอ้างอิงตัวตนของ gear
128- * *gearsecret* `string` - เป็น secret ของ key ซึ่งจะใช้ประกอบในกระบวนการยืนยันตัวตน
129- * *scope* `string` - เป็นการระบุขอบเขตของสิทธิ์ที่ต้องการ
130-
131- **scope**
132- เป็นการต่อกันของ string ในรูปแบบต่อไปนี้ คั่นด้วยเครื่องหมาย comma
133- * [r][w]:</topic/path> - r และ w คือสิทธิ์ในการ publish ละ subscribe topic ดังที่ระบุ เช่น rw:/outdoor/temp
134- * name:<gearname> - คือสิทธิ์ในการตั้งชื่อตัวเองว่า <gearname>
135- * chat:<gearname> - คือสิทธ์ในการ chat กับ <gearname>
136- ในขั้นตอนของการสร้าง key บนเว็บ netpie.io นักพัฒนาสามารถกำหนดสิทธิ์ขั้นพื้นฐานให้แต่ละ key ได้อยู่แล้ว หากการ create microgear อยู่ภายใต้ขอบเขตของสิทธิ์ที่มี token จะถูกจ่ายอัตโนมัติ และ microgear จะสามารถเชื่อมต่อ netpie platform ได้ทันที แต่หาก scope ที่ร้องขอนั้นมากเกินกว่าสิทธิ์ที่กำหนดไว้ นักพัฒนาจะได้รับ notification ให้พิจารณาอนุมัติ microgear ที่เข้ามาขอเชื่อมต่อ ข้อควรระวัง หาก microgear มีการกระทำการเกินกว่าสิทธิ์ที่ได้รับไป เช่น พยายามจะ publish ไปยัง topic ที่ตัวเองไม่มีสิทธิ์ netpie จะตัดการเชื่อมต่อของ microgear โดยอัตโนมัติ ในกรณีที่ใช้ APPKEY เป็น gearkey เราสามารถละเว้น attribute นี้ได้ เพราะ APPKEY จะได้สิทธิ์ทุกอย่างในฐานะของเจ้าของ app โดย default อยู่แล้ว
125+ * *key* `string` - เป็น key สำหรับ gear ที่จะรัน ใช้ในการอ้างอิงตัวตนของ gear
126+ * *secret* `string` - เป็น secret ของ key ซึ่งจะใช้ประกอบในกระบวนการยืนยันตัวตน
127+ * *alias* `string` - เป็นการระบุชื่อของ device
137128
138129```c++
139130microGear.init("sXfqDcXHzbFXiLk",
140131 "DNonzg2ivwS8ceksykGntrfQjxbL98",
141- "r:/outdoor/temp,w:/outdoor/valve,name:logger,chat:plant ");
132+ "myplant ");
142133```
0 commit comments