เรื่องราวการใช้งาน API

Mirror API มีชุดองค์ประกอบที่คุณใช้สร้างบริการสําหรับ Glass ได้ เนื่องจากบริการ Glass อาจจะต่างจากซอฟต์แวร์อื่นๆ ที่คุณพัฒนาไว้ จึงอาจไม่ชัดเจนว่าเหมาะสมกับฟีเจอร์ของ Mirror API อย่างไร

บริการหลายๆ รายการแบ่งการใช้งาน API ออกเป็น 2-3 หมวดหมู่ มาดูตัวอย่างภาพที่ผสานฟีเจอร์ต่างๆ ของ Mirror API เพื่อสร้างบริการ Glass กัน

ข้อเท็จจริงเกี่ยวกับแมว

การนําส่งเนื้อหาไปยังไทม์ไลน์ของ Glass เป็นการใช้งาน Google Mirror API ที่ใช้งานง่ายแต่ทรงพลัง แมวเหมียวตัวอย่าง Glassware ให้ข้อมูลข้อเท็จจริงเกี่ยวกับแมวแก่ผู้ใช้และอาจทําตามกระบวนการนี้ได้

  1. ผู้ใช้ไปที่เว็บแอปพลิเคชันและสมัครใช้บริการด้วยการตรวจสอบสิทธิ์ด้วย OAuth 2.0
  2. ทุกชั่วโมง บริการของคุณจะนําส่งข้อมูลแมวใหม่ไปยัง Glass ของผู้ใช้แต่ละราย

ระบบจะดําเนินการเกี่ยวกับแมวโดยใช้วิธีแทรกไทม์ไลน์ ดังนี้

โฟลว์ข้อมูลแมว

  1. ผู้ใช้สมัครใช้บริการโดยการตรวจสอบสิทธิ์ด้วย OAuth 2.0
  2. Cat Facts จัดเก็บดัชนีผู้ใช้และข้อมูลรับรองของผู้ใช้
  3. ทุกชั่วโมง Cat Facts จะเผยแพร่ข้อมูลแมวใหม่ ซึ่งทําได้โดยการทําซ้ําผู้ใช้ที่จัดเก็บไว้ทั้งหมดและแทรกรายการไทม์ไลน์ลงในไทม์ไลน์

เพิ่มแมวแถวนั้น

ความก้าวหน้าทางเทคโนโลยีของมนุษย์แต่ละขั้นตอนช่วยให้สามารถเผยแพร่รูปภาพแมวได้ดียิ่งขึ้น Project Glass ไม่ได้แตกต่างกัน

เนื่องจากรูปภาพทุกรูปจะดีกว่ากับแมว ดังนั้นบริการนี้จะช่วยให้ผู้ใช้สามารถผสมรูปภาพแมวแบบสุ่มและรูปที่ถ่ายด้วย Glass

  1. ผู้ใช้ไปยังเว็บแอปพลิเคชันและติดตั้ง Add to Cat to That โดยการตรวจสอบสิทธิ์ด้วย OAuth 2.0
  2. บริการของคุณจะสร้างรายชื่อติดต่อใหม่ใน Glass ของผู้ใช้ที่มีชื่อว่า "Add a Cat to That"
  3. ขณะที่ผู้ใช้ถ่ายรูป พวกเขาจะแชร์รูปภาพเหล่านั้นกับรูปแมวแมวเพิ่ม
  4. บริการของคุณจะรวมรูปภาพแมวแบบสุ่มไปยังรูปภาพที่แชร์
  5. สุดท้าย บริการของคุณส่งรูปแมวที่ได้รับการปรับปรุงไปยัง Glass ของผู้ใช้

สถาปัตยกรรมสําหรับบริการนี้จะเป็นไปตามโฟลว์ API นี้

เพิ่มแมวไปยังขั้นตอนนี้

  1. ผู้ใช้ให้สิทธิ์กับ OAuth 2.0 บริการของคุณจัดเก็บข้อมูลเข้าสู่ระบบของผู้ใช้
  2. หลังจากเต้น OAuth 2.0 เสร็จแล้ว บริการจะแทรกรายชื่อติดต่อที่ชื่อ "Add a Cat to That"
  3. ถัดไป บริการของคุณจะสมัครรับการอัปเดตในไทม์ไลน์ของผู้ใช้รายนี้โดยการแทรกการสมัครใช้บริการสําหรับคอลเล็กชัน timeline เพิ่มแมวไว้ในการตั้งค่าเรียบร้อยแล้ว
  4. เมื่อเวลาผ่านไป ผู้ใช้ถ่ายรูป
  5. ผู้ใช้แชร์รูปภาพพร้อมเพิ่มแมว ซึ่งจะทําให้การ์ดไทม์ไลน์ที่เชื่อมโยงกับรูปภาพนี้เข้าถึงบริการของคุณได้
  6. เนื่องจากบริการติดตามการอัปเดตไทม์ไลน์อยู่ ระบบจึงจะส่งการแจ้งเตือนไปยังบริการของคุณ การแจ้งเตือนนี้ลิงก์ไปยังรายการไทม์ไลน์ที่มีรูปภาพที่แชร์
  7. บริการจะตรวจสอบการแจ้งเตือนและใช้ id ที่รวมอยู่ในการดึงข้อมูลการ์ดไทม์ไลน์ที่มีรูปภาพดังกล่าว
  8. ถัดไป บริการจะตรวจสอบรายการไทม์ไลน์และใช้รหัสไฟล์แนบเพื่อดึงไบต์ของภาพถ่าย
  9. บริการของคุณจะเลือกรูปภาพแมวแบบสุ่มและแทรกลงในรูปภาพที่แชร์
  10. สุดท้าย บริการของคุณจะสร้างการ์ดไทม์ไลน์ใหม่ และแทรกลงในการ์ดไทม์ไลน์ของผู้ใช้โดยแนบรูปภาพที่อัปเดตกับแมว

ร้านสัตว์เลี้ยงในบริเวณใกล้เคียง

มีอะไรมากกว่าแค่ข้อมูลเกี่ยวกับแมว แมว หรือรูปแมว และจริงๆ แล้ว แมวตัวจริงขนยาว มิเรอร์ API ช่วยให้ทําได้ง่ายขึ้นโดยการตรวจสอบว่าร้านสัตว์เลี้ยงที่ใกล้ที่สุดอยู่ที่ไหน

การใช้งานจะมีลักษณะดังนี้

  1. ผู้ใช้ไปที่เว็บแอปพลิเคชันและสมัครใช้บริการด้วยการตรวจสอบสิทธิ์ด้วย OAuth 2.0
  2. บริการจะกําหนดตําแหน่งของผู้ใช้
  3. บริการของคุณค้นหาร้านขายสัตว์เลี้ยงที่ใกล้ที่สุด
  4. บริการของคุณจะแทรกการ์ดทางด้านซ้ายของนาฬิกาที่แสดงร้านขายสัตว์เลี้ยงที่อยู่ใกล้เคียง
  5. Glass จะแจ้งบริการของคุณเกี่ยวกับตําแหน่งของผู้ใช้
  6. สําหรับการแจ้งเตือนแต่ละรายการ บริการจะทําซ้ําการค้นหาร้านค้าสําหรับสัตว์เลี้ยงและอัปเดตการ์ดที่ปักหมุดไว้เพื่อแสดงถึงร้านขายสัตว์เลี้ยงที่ใกล้ที่สุด

การใช้บริการนี้เป็นไปตามขั้นตอน API นี้

ร้านสัตว์เลี้ยงในบริเวณใกล้เคียง

  1. ผู้ใช้ให้สิทธิ์กับ OAuth 2.0 นอกจากขอบเขต glass.timeline ปกติแล้ว แอปพลิเคชันของคุณยังขอสิทธิ์เข้าถึงขอบเขต glass.location ด้วย
  2. หลังจากเต้น OAuth 2.0 เสร็จแล้ว บริการก็จะติดตามการอัปเดตตําแหน่งของผู้ใช้
  3. ถัดไป บริการนี้จะดึงข้อมูลตําแหน่งล่าสุดของผู้ใช้จากปลายทางตําแหน่ง
  4. บริการของคุณค้นหาร้านขายสัตว์เลี้ยงใกล้ผู้ใช้
  5. บริการของคุณสร้างการ์ด timeline ที่แสดงผลการค้นหาร้านค้าสําหรับสัตว์เลี้ยง หากต้องการเก็บการ์ดนี้ไว้ที่ด้านซ้ายของหน้าจอนาฬิกา บริการจะปักหมุดการ์ดนี้ไว้
  6. ระบบจะอัปเดตสถานที่ล่าสุดขณะที่ผู้ใช้ไปยังส่วนต่างๆ
  7. เนื่องจากบริการติดตามการอัปเดตตําแหน่ง ระบบจึงจะส่งการแจ้งเตือนไปยังบริการของคุณ การแจ้งเตือนนี้ลิงก์กับรายการ latest ในคอลเล็กชัน location
  8. บริการของคุณจะดึงข้อมูล latest location ของผู้ใช้จากคอลเล็กชัน location ตามการแจ้งเตือนดังกล่าว
  9. ถัดไป บริการจะค้นหาร้านขายสัตว์เลี้ยงใกล้ผู้ใช้
  10. สุดท้าย บริการจะใช้เมธอด patch เพื่ออัปเดตเนื้อหาของรายการไทม์ไลน์ที่แทรกในขั้นตอนที่ 5