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

สร้างบัญชี Google

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

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

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

1. เปิดเครื่องมือจัดการ Android SDK
2. ในส่วน SDK Tools ให้ค้นหาบริการ 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.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.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:22.0.0'
}

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