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

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

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

ตั้งค่า

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

รับบัญชี Google

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

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

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

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

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

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

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

เราขอแนะนำให้ใช้สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ Android Studio เพื่อสร้างแอปที่มีฟิตเนส 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 ดาวน์โหลด 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

ดูตัวอย่างวิธีสร้างไคลเอ็นต์ฟิตเนส API

ผลลัพธ์ของขั้นตอนการให้สิทธิ์ผู้ใช้

รายการต่อไปนี้จะแสดงขั้นตอนการให้สิทธิ์ที่ผู้ใช้ได้รับเมื่อระบบขอสิทธิ์

ภาพที่ 1ขั้นตอนการให้สิทธิ์สำหรับผู้ใช้

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

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

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