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

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

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

ตั้งค่า

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

รับบัญชี Google

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

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

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

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

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

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

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

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

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

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

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