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

รับบัญชี 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 ดังนี้

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")
}

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 โดยอัตโนมัติเมื่อ สร้างแอปของคุณขึ้นมา

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