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

คู่มือนี้อธิบายวิธีเริ่มต้นพัฒนาแอปด้วย Google Fit บน Android

หมายเหตุ: Google Fit เป็นส่วนหนึ่งของบริการ Google Play ดูข้อมูลเกี่ยวกับ ประโยชน์ที่แอปจะได้รับจากการใช้บริการ ของ Google Play

ตั้งค่า

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

สร้างบัญชี Google

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

ติดตั้งบริการ Google Play

ดาวน์โหลดไลบรารีของไคลเอ็นต์ล่าสุดสำหรับบริการ Google Play ในโฮสต์การพัฒนา

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

รับรหัสไคลเอ็นต์ OAuth 2.0

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

สร้างและกำหนดค่าโปรเจ็กต์

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

เพิ่มไลบรารีของไคลเอ็นต์บริการ Google Play

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

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

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

ซึ่งจะช่วยให้มั่นใจได้ว่า Gradle จะดาวน์โหลด Fitness SDK โดยอัตโนมัติเมื่อ สร้างแอป

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

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

รับสิทธิ์ Android ที่จำเป็น

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

รับสิทธิ์ OAuth

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

สร้างไคลเอ็นต์ API

สร้างไคลเอ็นต์ 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. เข้าถึงแล้ว: หลังจากที่ผู้ใช้ให้สิทธิ์แล้ว แอปของคุณจะ เข้าถึงประเภทข้อมูลที่เป็นของขอบเขตที่ผู้ใช้ให้ สิทธิ์ได้

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

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