คู่มือนี้จะอธิบายวิธีเริ่มการพัฒนาด้วย Google Fit ใน Android
ตั้งค่า
ก่อนที่จะเริ่มสร้างแอป ให้ทําตามขั้นตอนต่อไปนี้
รับบัญชี Google
คุณต้องมีบัญชี Google เพื่อใช้ Google Fit API คุณสามารถสร้างบัญชีใหม่
หรือใช้บัญชีที่มีอยู่ก็ได้ คุณควรสร้างบัญชีแยกต่างหากเพื่อทดสอบ
แอปจากมุมมองของผู้ใช้
ติดตั้งบริการ Google Play
รับไลบรารีของไคลเอ็นต์ล่าสุดสําหรับบริการ Google Play ในโฮสต์การพัฒนา
เปิดโปรแกรมจัดการ SDK ของ Android
ในส่วนเครื่องมือ SDK ให้ค้นหาบริการ Google Play
หากสถานะของแพ็กเกจเหล่านี้ไม่ใช่ติดตั้งแล้ว ให้เลือกทั้ง 2 แพ็กเกจและคลิกติดตั้งแพ็กเกจ
เพิ่มไลบรารีของไคลเอ็นต์บริการ Google Play
ใน Android Studio ให้เปิดไฟล์ build.gradle
สําหรับโมดูลและเพิ่มไลบรารีของไคลเอ็นต์บริการ Google Play เป็นการอ้างอิง
DSL ของ Kotlin
plugin {
id("com.android.application")
}
...
dependencies {
implementation("com.google.android.gms:play-services-fitness:21.1.0")
implementation("com.google.android.gms:play-services-auth:20.7.0")
}
DSL ที่หลุม
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-fitness:21.1.0'
implementation 'com.google.android.gms:play-services-auth:20.7.0'
}
วิธีนี้ทําให้ Gradle ดาวน์โหลด SDK การออกกําลังกายโดยอัตโนมัติเมื่อสร้างแอป
สร้างและทดสอบแอป
หลังจากเสร็จสิ้นขั้นตอนการตั้งค่าแล้ว คุณจะเริ่มสร้างแอปได้ หากต้องการเริ่มต้นใช้งาน ให้เรียนรู้เกี่ยวกับประเภทข้อมูล ที่แอปสามารถจัดเก็บและอ่าน ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการทํางานกับข้อมูล ใน Google Fit
สร้างไคลเอ็นต์ API
สร้างไคลเอ็นต์ API และเพิ่มประเภทข้อมูลที่แอปของคุณจําเป็นต้องเข้าถึงเพื่อเขียนหรืออ่านข้อมูล อุปกรณ์ปลายทางที่ใช้ได้มีดังนี้
SensorsClient
: เข้าถึงแหล่งข้อมูลด้านสุขภาพและสุขภาวะต่างๆ จากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ท้องถิ่นและอุปกรณ์ที่ใช้ร่วมกัน
RecordingClient
: สําหรับการเก็บรวบรวมข้อมูลเซ็นเซอร์ในเบื้องหลังตลอดเวลาที่ใช้พลังงานต่ํา
HistoryClient
: แทรก ลบ และอ่านข้อมูลประวัติใน
Google Fit
SessionsClient
: สร้างและจัดการเซสชัน กิจกรรมของผู้ใช้
GoalsClient
: อ่านเป้าหมายคะแนนคาร์ดิโอและจํานวนก้าวที่สร้างโดยผู้ใช้ใน Google Fit
ConfigClient
: เข้าถึงประเภทข้อมูลและการตั้งค่าที่กําหนดเองในแพลตฟอร์ม Google Fit
ดูตัวอย่างวิธีสร้างไคลเอ็นต์ Fitness API
ขั้นตอนการให้สิทธิ์จากผู้ใช้
ข้อมูลต่อไปนี้จะแสดงขั้นตอนการให้สิทธิ์ที่ผู้ใช้จะได้รับ
เมื่อขอสิทธิ์
ภาพที่ 1 ขั้นตอนการให้สิทธิ์สําหรับผู้ใช้
สิทธิ์ของ Android : ผู้ใช้จะเห็นสิทธิ์ที่ Android จะขอจากแอปของคุณก่อนที่จะดาวน์โหลด หลังจากดาวน์โหลดแอปแล้ว แอปจะขอสิทธิ์รันไทม์ที่จําเป็นและผู้ใช้จะให้สิทธิ์หรือปฏิเสธก็ได้
ตรวจสอบและเชื่อมต่อ : แอปจะตรวจสอบสิทธิ์ก่อนที่จะขอสิทธิ์ในการเข้าถึงข้อมูลประเภทอื่นๆ หรือไม่
คําขอขอบเขต OAuth : Google แจ้งให้ผู้ใช้ให้สิทธิ์ขอบเขต OAuth ที่จําเป็นสําหรับประเภทข้อมูลที่แอปต้องการเข้าถึง
สิทธิ์เข้าถึงที่ใช้ : หลังจากที่ผู้ใช้ให้สิทธิ์แล้ว แอปของคุณจะเข้าถึงประเภทข้อมูลที่อยู่ในขอบเขตที่ผู้ใช้ให้สิทธิ์ได้
สมัครรับการยืนยัน
หลังจากสร้างและทดสอบแอปแล้ว คุณต้องสมัครรับการยืนยัน ที่มีเหตุผลรองรับที่แตกต่างกันซึ่งจําเป็นสําหรับขอบเขตที่ละเอียดอ่อนและถูกจํากัด