เริ่มต้นใช้งานบน Android

คำแนะนำนี้อธิบายวิธีเริ่มการพัฒนาด้วย Google Fit ใน Android

ตั้งค่า

โปรดทำตามขั้นตอนต่อไปนี้ก่อนเริ่มสร้างแอป

คุณต้องมีบัญชี Google เพื่อใช้ API ของ Google Fit คุณสามารถสร้างบัญชีใหม่ หรือ ใช้บัญชีที่มีอยู่ คุณอาจต้องสร้างบัญชีแยกต่างหากเพื่อทดสอบ แอปของคุณจากมุมมองของผู้ใช้

รับไลบรารีไคลเอ็นต์ล่าสุดสำหรับบริการ Google Play ในการพัฒนา เจ้าภาพ:

  1. เปิด Android SDK Manager
  2. ในส่วนเครื่องมือ SDK ให้ค้นหาบริการ Google Play
  3. หากสถานะของแพ็กเกจเหล่านี้ไม่ใช่ติดตั้งแล้ว ให้เลือกทั้ง 2 แพ็กเกจ แล้วคลิกติดตั้งแพ็กเกจ

หากต้องการเปิดใช้ Fitness API โปรดรับรหัสไคลเอ็นต์ OAuth 2.0

เราขอแนะนำให้ใช้สภาพแวดล้อมในการพัฒนาของ Android Studio เพื่อสร้างแอปด้วย Fitness API สำหรับ รายละเอียดเกี่ยวกับวิธีสร้างโปรเจ็กต์ใหม่และกำหนดค่าใน Android Studio โปรดดู สร้างโปรเจ็กต์

ใน Android Studio ให้เปิดไฟล์ build.gradle สำหรับโมดูลและเพิ่มไลบรารีไคลเอ็นต์ของบริการ Google Play เป็นทรัพยากร Dependency ดังนี้

Kotlin DSLDSL กรูฟฟี่
plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}
 
apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.3.0'
}

เพื่อให้ Gradle ดาวน์โหลด Fitness SDK โดยอัตโนมัติเมื่อ สร้างแอปของคุณขึ้นมา

สร้างและทดสอบแอป

หลังจากทำตามขั้นตอนการตั้งค่าเสร็จแล้ว คุณก็เริ่มสร้างแอปได้ โดยวิธีการมีดังนี้ เรียนรู้เกี่ยวกับประเภทของข้อมูลที่แอปของคุณสามารถจัดเก็บและ อ่านแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำงานร่วมกับ ข้อมูลใน Google Fit

หากต้องการอ่านและเขียนข้อมูลบางประเภท แอปของคุณต้องขอสิทธิ์ Android

ประเภทข้อมูลที่แอปมีสิทธิ์เข้าถึงจะสอดคล้องกับประเภท ขอบเขตการให้สิทธิ์ วิธีถาม สำหรับสิทธิ์เหล่านี้ คุณต้องเพิ่ม ประเภทข้อมูลที่แอปของคุณต้องเข้าถึงใน FitnessOptions อินสแตนซ์ เมื่อแอปขอใช้ข้อมูล Google Fit Android SDK จะตรวจสอบโดยอัตโนมัติว่าอยู่ในขอบเขตใดและถาม ผู้ใช้เพื่อให้สิทธิ์ในขอบเขตเหล่านั้น

สร้างไคลเอ็นต์ API และเพิ่มประเภทข้อมูลที่แอปจำเป็นต้องเข้าถึง เขียนหรืออ่านข้อมูล ปลายทางที่พร้อมใช้งานมีดังนี้

  • SensorsClient: เข้าถึงแหล่งข้อมูลด้านสุขภาพและความแข็งแรงสมบูรณ์จากแหล่งข้อมูลต่างๆ จากเซ็นเซอร์ของฮาร์ดแวร์ในอุปกรณ์ภายในและในอุปกรณ์ที่ใช้ร่วมกัน
  • RecordingClient: สำหรับการรวบรวมข้อมูลเซ็นเซอร์ในเบื้องหลังพลังงานต่ำและเปิดอยู่ตลอดเวลา
  • HistoryClient: แทรก ลบ และอ่านข้อมูลย้อนหลังใน Google Fit
  • SessionsClient: สร้างและจัดการเซสชันกิจกรรมของผู้ใช้
  • GoalsClient: อ่านเป้าหมายคะแนนคาร์ดิโอและจํานวนก้าวที่ผู้ใช้ใน Google Fit สร้างขึ้น
  • ConfigClient: เข้าถึงประเภทข้อมูลที่กำหนดเองและการตั้งค่าในแพลตฟอร์ม Google Fit

ดูตัวอย่างวิธีสร้างไคลเอ็นต์ Fitness API

ข้อมูลต่อไปนี้จะแสดงขั้นตอนการให้สิทธิ์ที่ได้แก่ผู้ใช้ เมื่อมีการขอสิทธิ์

วันที่
รูปที่ 1ขั้นตอนการให้สิทธิ์แก่ผู้ใช้
  1. สิทธิ์ของ Android: ผู้ใช้จะเห็นสิทธิ์ของ Android ที่แอปของคุณ ได้ส่งคำขอก่อนดาวน์โหลด หลังจากดาวน์โหลดแอปแล้ว ขอสิทธิ์รันไทม์ใดๆ ที่จำเป็นและผู้ใช้ให้หรือปฏิเสธ สิทธิ์เหล่านี้
  2. ตรวจสอบและเชื่อมต่อ: แอปจะตรวจสอบว่าสิทธิ์ อนุญาตก่อนที่จะขอสิทธิ์เข้าถึงข้อมูลประเภทอื่นๆ
  3. คำขอขอบเขต OAuth: Google จะแจ้งให้ผู้ใช้ให้สิทธิ์แอปของคุณ ขอบเขต OAuth ที่จำเป็นสำหรับประเภทข้อมูลที่ต้องการเข้าถึง
  4. ใช้สิทธิ์เข้าถึงแล้ว: หลังจากผู้ใช้ให้สิทธิ์แล้ว แอปจะทำสิ่งต่อไปนี้ได้ เข้าถึงประเภทข้อมูลที่อยู่ในขอบเขตที่ผู้ใช้ให้สิทธิ์ สิทธิ์สำหรับ

สมัครรับการยืนยัน

หลังจากที่สร้างและทดสอบแอปแล้ว คุณจะต้องสมัครใช้ ยืนยันด้วยหมายเลข ระดับการให้เหตุผลที่จำเป็นสำหรับ ขอบเขตที่จำกัดและละเอียดอ่อน