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

สร้างบัญชี Google

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

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

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

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

รับรหัสไคลเอ็นต์ 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:21.5.1")
}

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.5.1'
}

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