คู่มือนี้อธิบายวิธีเริ่มพัฒนาด้วย Google Fit บน Android
ตั้งค่า
ก่อนที่จะเริ่มสร้างแอป ให้ทำตามขั้นตอนในส่วนต่อไปนี้
รับบัญชี Google
คุณต้องมีบัญชี Google เพื่อใช้ API ของ Google Fit คุณจะสร้างบัญชีใหม่ หรือใช้บัญชีที่มีอยู่ก็ได้ คุณอาจต้องการสร้างบัญชีแยกต่างหากเพื่อทดสอบแอป
จากมุมมองของผู้ใช้
ติดตั้งบริการ Google Play
ดาวน์โหลดไลบรารีของไคลเอ็นต์ล่าสุดสำหรับบริการ Google Play ในโฮสต์การพัฒนา
เปิด Android SDK Manager
ค้นหาบริการ Google Play ในส่วนเครื่องมือ SDK
หากสถานะของแพ็กเกจเหล่านี้ไม่ใช่ติดตั้ง ให้เลือกทั้ง 2 แพ็กเกจ แล้วคลิกติดตั้งแพ็กเกจ
เพิ่มไลบรารีของไคลเอ็นต์บริการ Google Play
ใน Android Studio ให้เปิดไฟล์ build.gradle
ของโมดูลและเพิ่มไลบรารีของไคลเอ็นต์บริการ Google Play เป็นทรัพยากร Dependency ดังนี้
Kotlin DSL
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.2.0")
}
DSL ที่สนุกสนาน
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.2.0'
}
วิธีนี้ช่วยให้ Gradle ดาวน์โหลด SDK การออกกำลังกายโดยอัตโนมัติเมื่อสร้างแอป
สร้างและทดสอบแอป
หลังจากทำตามขั้นตอนการตั้งค่าเสร็จแล้ว คุณจะเริ่มสร้างแอปได้ หากต้องการเริ่มต้นใช้งาน ให้เรียนรู้เกี่ยวกับประเภทของข้อมูล ที่แอปของคุณสามารถจัดเก็บและอ่าน ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำงานกับข้อมูล ใน Google Fit
สร้างไคลเอ็นต์ API
สร้างไคลเอ็นต์ API และเพิ่มประเภทข้อมูลที่แอปต้องการเข้าถึงเพื่อเขียนหรืออ่านข้อมูล ปลายทางต่อไปนี้พร้อมใช้งาน
SensorsClient
: เข้าถึงแหล่งข้อมูลด้านสุขภาพและความแข็งแรงสมบูรณ์จากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ในพื้นที่และอุปกรณ์ที่ใช้ร่วมกัน
RecordingClient
: สำหรับการเก็บข้อมูลเซ็นเซอร์ในพื้นหลังพลังงานต่ำที่เปิดตลอดเวลา
HistoryClient
: แทรก ลบ และอ่านข้อมูลย้อนหลังใน Google Fit
SessionsClient
: สร้างและจัดการเซสชัน กิจกรรมของผู้ใช้
GoalsClient
: อ่านเป้าหมายคะแนนคาร์ดิโอและจำนวนก้าวที่ผู้ใช้ใน Google Fit สร้างขึ้น
ConfigClient
: เข้าถึงประเภทข้อมูลและการตั้งค่าที่กำหนดเองในแพลตฟอร์ม Google Fit
ดูตัวอย่างวิธีสร้างไคลเอ็นต์ฟิตเนส API
ผลลัพธ์ของขั้นตอนการให้สิทธิ์ผู้ใช้
รายการต่อไปนี้จะแสดงขั้นตอนการให้สิทธิ์ที่ผู้ใช้ได้รับเมื่อระบบขอสิทธิ์
ภาพที่ 1 ขั้นตอนการให้สิทธิ์สำหรับผู้ใช้
สิทธิ์ของ Android : ผู้ใช้จะเห็นสิทธิ์ Android ที่แอปของคุณขอก่อนดาวน์โหลด หลังจากดาวน์โหลดแอปแล้ว แอปจะขอสิทธิ์รันไทม์ที่ต้องการ แล้วผู้ใช้จะอนุญาตหรือปฏิเสธสิทธิ์เหล่านี้
ตรวจสอบและเชื่อมต่อ : แอปจะตรวจสอบว่าได้ให้สิทธิ์แล้วหรือยังก่อนที่จะขอเข้าถึงข้อมูลประเภทอื่นๆ
คำขอขอบเขต OAuth : Google จะแจ้งให้ผู้ใช้มอบขอบเขต OAuth ที่จำเป็นสำหรับประเภทข้อมูลที่ต้องการเข้าถึงให้กับแอปของคุณ
ใช้สิทธิ์เข้าถึงแล้ว : หลังจากที่ผู้ใช้ให้สิทธิ์แล้ว แอปของคุณจะเข้าถึงประเภทข้อมูลที่อยู่ในขอบเขตที่ผู้ใช้ได้ให้สิทธิ์ไว้
สมัครรับการยืนยัน
หลังจากสร้างและทดสอบแอปแล้ว คุณต้องสมัครรับการยืนยัน ด้วยการให้เหตุผลในระดับต่างๆ ที่จำเป็นสำหรับขอบเขตที่ละเอียดอ่อนและจำกัด