ใช้งานเซสชัน

เซสชันแสดงระยะเวลาที่ผู้ใช้ออกกําลังกาย API เซสชันช่วยให้แอปสร้างเซสชันใน Store การออกกําลังกายได้

สําหรับกิจกรรมการออกกําลังกายที่กําลังดําเนินอยู่ซึ่งผู้ใช้ได้แจ้งว่าแอปของคุณมาจากกิจกรรมเริ่มต้น และเริ่มต้นกิจกรรมการออกกําลังกาย คุณสามารถสร้างเซสชันแบบเรียลไทม์ได้

คุณยังแทรกเซสชันลงในร้านฟิตเนสหลังกิจกรรมการออกกําลังกายจบลงหรือเมื่อนําเข้าข้อมูลและเซสชันจากภายนอก Google Fit ได้อีกด้วย

สร้างเซสชันแบบเรียลไทม์

หากต้องการสร้างเซสชันสําหรับกิจกรรมการออกกําลังกายที่ดําเนินอยู่ ให้ทําตามขั้นตอนต่อไปนี้

  1. สมัครใช้บริการข้อมูลการออกกําลังกายโดยใช้เมธอด RecordingClient.subscribe

  2. เริ่มเซสชันโดยใช้เมธอด SessionsClient.startSession เมื่อผู้ใช้เริ่มต้นกิจกรรมการออกกําลังกาย

  3. หยุดเซสชันโดยใช้เมธอด SessionsClient.stopSession เมื่อผู้ใช้สิ้นสุดกิจกรรมการออกกําลังกาย

  4. ยกเลิกการสมัครรับข้อมูลการออกกําลังกายที่คุณไม่สนใจจะใช้เมธอด RecordingClient.unsubscribe อีกต่อไป

เริ่มเซสชัน

วิธีใช้เซสชัน SessionsClient.startSession ในแอป

Kotlin

// 1. Subscribe to fitness data
// 2. Create a session object
// (provide a name, identifier, description, activity and start time)
val session = Session.Builder()
    .setName(sessionName)
    .setIdentifier("UniqueIdentifierHere")
    .setDescription("Morning run")
    .setActivity(FitnessActivities.RUNNING)
    .setStartTime(startTime, TimeUnit.MILLISECONDS)
    .build()

// 3. Use the Sessions client to start a session:
Fitness.getSessionsClient(this, googleSigninAccount)
    .startSession(session)
    .addOnSuccessListener {
        Log.i(TAG, "Session started successfully!")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "There was an error starting the session", e)
    }

Java

// 1. Subscribe to fitness data
// 2. Create a session object
// (provide a name, identifier, description, activity and start time)
Session session = new Session.Builder()
        .setName(sessionName)
        .setIdentifier("UniqueIdentifierHere")
        .setDescription("Morning run")
        .setActivity(FitnessActivities.RUNNING)
        .setStartTime(startTime, TimeUnit.MILLISECONDS)
        .build();

// 3. Use the Sessions client to start a session:
Fitness.getSessionsClient(this, googleSigninAccount)
        .startSession(session)
        .addOnSuccessListener(unused ->
                Log.i(TAG, "Session started successfully!"))
        .addOnFailureListener(e ->
                Log.w(TAG, "There was an error starting the session", e));

หยุดเซสชัน

หากต้องการหยุดเซสชันในแอป ให้ใช้เมธอด SessionsClient.stopSession ดังนี้

Kotlin

// Invoke the SessionsClient with the session identifier
Fitness.getSessionsClient(this, googleSigninAccount)
    .stopSession(session.getIdentifier())
    .addOnSuccessListener {
        Log.i(TAG, "Session stopped successfully!")

        // Now unsubscribe from the fitness data (see
        // Recording Fitness data)
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "There was an error stopping the session", e)
    }

Java

// Invoke the SessionsClient with the session identifier
Fitness.getSessionsClient(this, googleSigninAccount)
        .stopSession(session.getIdentifier())
        .addOnSuccessListener (unused -> {
            Log.i(TAG, "Session stopped successfully!");
            // Now unsubscribe from the fitness data (see
            // Recording Fitness data)
        })
        .addOnFailureListener(e ->
                Log.w(TAG, "There was an error stopping the session", e));

เซสชันที่ได้มีพารามิเตอร์ต่อไปนี้

  • เวลาเริ่มต้น: เวลาที่แอปเรียกใช้เมธอด SessionsClient.startSession

  • เวลาสิ้นสุด: เวลาที่แอปเรียกใช้เมธอด SessionsClient.stopSession

  • ชื่อ: ชื่อในออบเจ็กต์ Session ที่คุณส่งถึง SessionsClient.startSession

แทรกเซสชันในศูนย์ฟิตเนส

หากต้องการแทรกเซสชันซึ่งมีข้อมูลที่รวบรวมไว้ก่อนหน้านี้ ให้ทําดังนี้

  1. สร้างออบเจ็กต์ Session ที่ระบุช่วงเวลาและข้อมูลที่จําเป็นอื่นๆ

  2. สร้าง SessionInsertRequest ด้วยเซสชัน

  3. เพิ่มชุดข้อมูลและจุดข้อมูลโดยรวม (ไม่บังคับ)

  4. แทรกเซสชันโดยใช้เมธอด SessionsClient.insertSession

แทรกเซสชัน

หากต้องการแทรกข้อมูลการออกกําลังกายที่มีข้อมูลเมตาของเซสชันลงในประวัติการออกกําลังกายของผู้ใช้ ให้สร้างอินสแตนซ์ SessionInsertRequest ก่อน

Kotlin

// Create a session with metadata about the activity.
val session = Session.Builder()
    .setName(SAMPLE_SESSION_NAME)
    .setIdentifier("UniqueIdentifierHere")
    .setDescription("Long run around Shoreline Park")

    .setActivity(FitnessActivities.RUNNING)
    .setStartTime(startTime, TimeUnit.MILLISECONDS)
    .setEndTime(endTime, TimeUnit.MILLISECONDS)
    .build()

// Build a session insert request
val insertRequest = SessionInsertRequest.Builder()
    .setSession(session)
    // Optionally add DataSets for this session.
    .addDataSet(dataset)
    .build()

Java

// Create a session with metadata about the activity.
Session session = new Session.Builder()
        .setName(SAMPLE_SESSION_NAME)
        .setIdentifier("UniqueIdentifierHere")
        .setDescription("Long run around Shoreline Park")

        .setActivity(FitnessActivities.RUNNING)
        .setStartTime(startTime, TimeUnit.MILLISECONDS)
        .setEndTime(endTime, TimeUnit.MILLISECONDS)
        .build();

// Build a session insert request
SessionInsertRequest insertRequest = new SessionInsertRequest.Builder()
        .setSession(session)
        // Optionally add DataSets for this session.
        .addDataSet(dataset)
        .build();

คลาส SessionInsertRequest มอบวิธีแทรกข้อมูลลงในประวัติการออกกําลังกายและสร้างเซสชันไว้ในการเรียกเดียวกันไปยัง SessionsClient.insertSession ระบบจะแทรกชุดข้อมูล (หากมี) เหมือนกับว่าคุณได้เรียกใช้เมธอด HistoryClient.insertData ก่อน จากนั้นจึงสร้างเซสชัน

Kotlin

Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .insertSession(insertRequest)
    .addOnSuccessListener {
        Log.i(TAG, "Session insert was successful!")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "There was a problem inserting the session: ", e)
    }

Java

Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        .insertSession(insertRequest)
        .addOnSuccessListener (unused ->
                Log.i(TAG, "Session insert was successful!"))
        .addOnFailureListener(e ->
        Log.w(TAG, "There was a problem inserting the session: ", e));

แทรกกลุ่มกิจกรรม

ข้อมูลกลุ่มกิจกรรมใน Google Fit ระบุว่าผู้ใช้ออกกําลังกาย ออกกําลังกายอย่างไรในช่วงเวลาที่กําหนด ข้อมูลกลุ่มกิจกรรมเป็น ประเภท com.google.activity.segment (TYPE_ACTIVITY_SEGMENT) และจะมีประโยชน์เป็นพิเศษเพื่อรองรับการหยุดชั่วคราวระหว่างการออกกําลังกาย

เช่น หากคุณสร้างเซสชันการเรียกใช้ 30 นาทีด้วยเมธอด Session.Builder.setActivity() แต่ผู้ใช้ใช้เวลา 10 นาทีระหว่างรอ แอปก็จะแสดงผู้ใช้ทํางานไป 30 นาที หากแอปของคุณสามารถตรวจสอบได้ว่าผู้ใช้กําลังเดินหรือวิ่งอยู่ ข้อมูลกลุ่มกิจกรรมช่วยให้แอประบุว่าผู้ใช้วิ่ง 10 นาที เดิน 10 นาที และลงอีก 10 นาที แอปอื่นๆ ยังสามารถรายงานกิจกรรมได้อย่างถูกต้องโดย ดูข้อมูลกลุ่มกิจกรรมที่คุณแทรก

หากต้องการเพิ่มข้อมูลกลุ่มกิจกรรมลงในเซสชัน ให้สร้างชุดข้อมูลที่มีคะแนนประเภท com.google.activity.segment จุดแต่ละจุดแสดงถึง ช่วงเวลาต่อเนื่องที่ผู้ใช้ทํากิจกรรมประเภทใดประเภทหนึ่ง

ตัวอย่างการวิ่งและเดินก่อนหน้านี้ต้องใช้จุดของกิจกรรม 3 จุด จุดหนึ่งสําหรับวิ่งระหว่าง 10 นาทีแรก และอีกจุดสําหรับทํางานระหว่าง 10 นาทีถัดไป และอีกจุดสําหรับทํางานในช่วง 10 นาทีสุดท้าย

Kotlin

// Create a DataSet of ActivitySegments to indicate the runner walked for
// 10 minutes in the middle of a run.
val activitySegmentDataSource = DataSource.Builder()
    .setAppPackageName(this.packageName)
    .setDataType(DataType.TYPE_ACTIVITY_SEGMENT)
    .setStreamName(SAMPLE_SESSION_NAME + "-activity segments")
    .setType(DataSource.TYPE_RAW)
    .build()

val firstRunningDp = DataPoint.builder(activitySegmentDataSource)
    .setActivityField(Field.FIELD_ACTIVITY, FitnessActivities.RUNNING)
    .setTimeInterval(startTime, startWalkTime, TimeUnit.MILLISECONDS)
    .build()

val walkingDp = DataPoint.builder(activitySegmentDataSource)
    .setActivityField(Field.FIELD_ACTIVITY, FitnessActivities.WALKING)
    .setTimeInterval(startWalkTime, endWalkTime, TimeUnit.MILLISECONDS)
    .build()

val secondRunningDp = DataPoint.builder(activitySegmentDataSource)
    .setActivityField(Field.FIELD_ACTIVITY, FitnessActivities.RUNNING)
    .setTimeInterval(endWalkTime, endTime, TimeUnit.MILLISECONDS)
    .build()

val activitySegments = DataSet.builder(activitySegmentDataSource)
    .addAll(listOf(firstRunningDp, walkingDp, secondRunningDp))
    .build()

// Create a session with metadata about the activity.
val session = Session.Builder()
    .setName(SAMPLE_SESSION_NAME)
    .setDescription("Long run around Shoreline Park")
    .setIdentifier("UniqueIdentifierHere")
    .setActivity(FitnessActivities.RUNNING)
    .setStartTime(startTime, TimeUnit.MILLISECONDS)
    .setEndTime(endTime, TimeUnit.MILLISECONDS)
    .build()

// Build a session insert request
val insertRequest = SessionInsertRequest.Builder()
    .setSession(session)
    .addDataSet(activitySegments)
    .build()

Java

// Create a DataSet of ActivitySegments to indicate the runner walked for
// 10 minutes in the middle of a run.
DataSource activitySegmentDataSource = new DataSource.Builder()
        .setAppPackageName(getPackageName())
        .setDataType(DataType.TYPE_ACTIVITY_SEGMENT)
        .setStreamName(SAMPLE_SESSION_NAME + "-activity segments")
        .setType(DataSource.TYPE_RAW)
        .build();

DataPoint firstRunningDp = DataPoint.builder(activitySegmentDataSource)
        .setActivityField(Field.FIELD_ACTIVITY, FitnessActivities.RUNNING)
        .setTimeInterval(startTime, startWalkTime, TimeUnit.MILLISECONDS)
        .build();

DataPoint walkingDp = DataPoint.builder(activitySegmentDataSource)
        .setActivityField(Field.FIELD_ACTIVITY, FitnessActivities.WALKING)
        .setTimeInterval(startWalkTime, endWalkTime, TimeUnit.MILLISECONDS)
        .build();

DataPoint secondRunningDp = DataPoint.builder(activitySegmentDataSource)
        .setActivityField(Field.FIELD_ACTIVITY, FitnessActivities.RUNNING)
        .setTimeInterval(endWalkTime, endTime, TimeUnit.MILLISECONDS)
        .build();

DataSet activitySegments = DataSet.builder(activitySegmentDataSource)
        .addAll(Arrays.asList(firstRunningDp, walkingDp, secondRunningDp))
        .build();

// Create a session with metadata about the activity.
Session session = new Session.Builder()
        .setName(SAMPLE_SESSION_NAME)
        .setDescription("Long run around Shoreline Park")
        .setIdentifier("UniqueIdentifierHere")
        .setActivity(FitnessActivities.RUNNING)
        .setStartTime(startTime, TimeUnit.MILLISECONDS)
        .setEndTime(endTime, TimeUnit.MILLISECONDS)
        .build();

// Build a session insert request
SessionInsertRequest insertRequest = new SessionInsertRequest.Builder()
        .setSession(session)
        .addDataSet(activitySegments)
        .build();

อ่านข้อมูลการออกกําลังกายโดยใช้เซสชัน

API เซสชันช่วยให้คุณรับรายการเซสชันจากสโตร์การออกกําลังกายที่ตรงกับเกณฑ์บางประการ ตัวอย่างเช่น คุณสามารถรับข้อมูลเซสชันทั้งหมดที่อยู่ในช่วงเวลาหนึ่งๆ หรือรับเซสชันที่เจาะจงตามชื่อหรือรหัสก็ได้ คุณยังระบุได้ว่า คุณสนใจเซสชันที่แอปสร้างขึ้นหรือในแอปใดก็ตาม

หากต้องการดูรายการเซสชันที่ตรงกับเกณฑ์บางประการ ให้สร้างอินสแตนซ์ของ SessionReadRequest ก่อน ดังนี้

Kotlin

// Use a start time of 1 week ago and an end time of now.
val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault())
val startTime = endTime.minusWeeks(1)

// Build a session read request
val readRequest = SessionReadRequest.Builder()
    .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS)
    .read(DataType.TYPE_SPEED)
    .setSessionName(SAMPLE_SESSION_NAME)
    .build()

Java

// Use a start time of 1 week ago and an end time of now.
ZonedDateTime endTime = LocalDateTime.now().atZone(ZoneId.systemDefault())
ZonedDateTime startTime = endTime.minusWeeks(1)

// Build a session read request
SessionReadRequest readRequest = new SessionReadRequest.Builder()
        .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS)
        .read(DataType.TYPE_SPEED)
        .setSessionName(SAMPLE_SESSION_NAME)
        .build();

จากนั้นใช้เมธอด SessionsClient.readSession ดังนี้

Kotlin

Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .readSession(readRequest)
    .addOnSuccessListener { response ->
        // Get a list of the sessions that match the criteria to check the result.
        val sessions = response.sessions
        Log.i(TAG, "Number of returned sessions is: ${sessions.size}")
        for (session in sessions) {
            // Process the session
            dumpSession(session)

            // Process the data sets for this session
            val dataSets = response.getDataSet(session)
            for (dataSet in dataSets) {
                // ...
            }
        }
    }
    .addOnFailureListener { e ->
        Log.w(TAG,"Failed to read session", e)
    }

Java

Fitness.getSessionsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        .readSession(readRequest)
        .addOnSuccessListener(response -> {
            // Get a list of the sessions that match the criteria to check the
            // result.
            List<Session> sessions = response.getSessions();
            Log.i(TAG, "Number of returned sessions is: ${sessions.size}");
            for (Session session : sessions) {
                // Process the session
                dumpSession(session);

                // Process the data sets for this session
                List<DataSet> dataSets = response.getDataSet(session);
                for (DataSet dataSet : dataSets) {
                    // ...
                }
            }
        })
        .addOnFailureListener(e ->
                Log.w(TAG,"Failed to read session", e));

อ่านข้อมูลการนอนหลับโดยใช้เซสชัน

เซสชันการนอนหลับจะถือว่าต่างจากเซสชันกิจกรรมอื่นๆ โดยค่าเริ่มต้น คําตอบในการอ่านจะมีเฉพาะเซสชันกิจกรรมเท่านั้น ไม่ใช่เซสชันการนอนหลับ

หากต้องการรวมเซสชันการนอนหลับ ให้ใช้เมธอด includeSleepSessions เมื่อสร้าง SessionReadRequest หากต้องการรวมทั้งกิจกรรมและเซสชัน ให้ใช้ทั้ง includeSleepSessions และ includeActivitySessions

แสดงเซสชันในแอปอื่นๆ

แอปอาจเรียก Intent ที่มีข้อมูลเซสชันเพื่อแสดงให้ผู้ใช้เห็นเซสชันใดเซสชันหนึ่งโดยละเอียดในแอปอื่น คุณสามารถระบุแอปเฉพาะได้ เช่น แอปที่สร้างเซสชันนี้ หรือในกรณีที่ แอปที่สร้างเซสชันไม่ได้ติดตั้งอยู่ในอุปกรณ์ คุณก็อาจอนุญาตแอปที่แสดงกิจกรรมการออกกําลังกายให้ตอบสนองความตั้งใจได้

หากต้องการสร้าง Intent เพื่อแสดงข้อมูลเซสชันในแอปอื่น ให้ใช้คลาส SessionsApi.ViewIntentBuilder

Kotlin

// Pass your activity object to the constructor
val intent = SessionsApi.ViewIntentBuilder(this)
    .setPreferredApplication("com.example.someapp") // optional
    .setSession(session)
    .build()

// Invoke the intent
startActivity(intent)

Java

// Pass your activity object to the constructor
Intent intent = new SessionsApi.ViewIntentBuilder(this)
        .setPreferredApplication("com.example.someapp") // optional
        .setSession(session)
        .build();

// Invoke the intent
startActivity(intent);

รับ Intent จากแอปอื่นๆ

หากต้องการลงทะเบียนแอปเพื่อรับ Intent จากแอปด้านสุขภาพและสุขภาวะอื่นๆ โปรดประกาศตัวกรอง Intent ในไฟล์ Manifest ที่คล้ายกับรายการต่อไปนี้

<intent-filter>
    <action android:name="vnd.google.fitness.VIEW"/>
    <data android:mimeType="vnd.google.fitness.session/running"/>
</intent-filter>

Intent แต่ละรายการที่แอปได้รับจาก Google Fit เป็นเพียงกิจกรรมเดียว แต่คุณกรอง MIME ได้หลายประเภทในตัวกรอง Intent เดียว ตัวกรอง Intent ของแอปต้องการรวมกิจกรรมทั้งหมดที่แอปรองรับ

Intent ของฟิตเนสประกอบด้วยบริการเสริมต่อไปนี้

  • vnd.google.gms.fitness.start_time
  • vnd.google.gms.fitness.end_time
  • vnd.google.gms.fitness.session

คุณสามารถดึงข้อมูลจากสิทธิพิเศษเหล่านี้ได้ดังนี้

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    val supportedType = Session.getMimeType(FitnessActivities.RUNNING)

    if (Intent.ACTION_VIEW == intent.action && supportedType == intent.type) {
        // Get the intent extras
        val startTime = Fitness.getStartTime(intent, TimeUnit.MILLISECONDS);
        val endTime = Fitness.getEndTime(intent, TimeUnit.MILLISECONDS)
        val session = Session.extract(intent)
    }
}

Java

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...

    String supportedType = Session.getMimeType(FitnessActivities.RUNNING);

    if (Intent.ACTION_VIEW.equals(getIntent().getAction()) && supportedType.equals(getIntent().getType())) {
        // Get the intent extras
        long startTime = Fitness.getStartTime(getIntent(), TimeUnit.MILLISECONDS);
        long endTime = Fitness.getEndTime(getIntent(), TimeUnit.MILLISECONDS);
        Session session = Session.extract(getIntent());
    }
}