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

รับบัญชี Google

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

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

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

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

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

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

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

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

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

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

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

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:21.4.0'
}

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

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

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

รับสิทธิ์ OAuth

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

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