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

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

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

ตั้งค่า

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

รับบัญชี Google

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

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

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

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

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

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

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

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

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

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

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

Groovy 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.3.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

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

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

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

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

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

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

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