Bekerja dengan sesi

Sesi mewakili interval waktu saat pengguna melakukan aktivitas kebugaran. Sessions API memungkinkan aplikasi Anda membuat sesi di penyimpanan kebugaran.

Untuk aktivitas kebugaran yang berkelanjutan saat pengguna memberi tahu aplikasi Anda saat mereka memulai dan menyelesaikan aktivitas kebugaran, Anda dapat membuat sesi secara real time.

Anda juga dapat menyisipkan sesi ke dalam penyimpanan kebugaran setelah aktivitas kebugaran selesai atau saat Anda mengimpor data dan sesi dari luar Google Fit.

Catatan: Untuk praktik terbaik saat Anda mengelola data pengguna, lihat Kebijakan Developer dan Data Pengguna Google Fit.

Buat sesi secara real time

Untuk membuat sesi bagi aktivitas kebugaran yang sedang berlangsung, selesaikan langkah-langkah berikut:

1. Berlangganan data kebugaran menggunakan metode RecordingClient.subscribe.

2. Mulai sesi menggunakan metode SessionsClient.startSession saat pengguna memulai aktivitas kebugaran.

3. Hentikan sesi menggunakan metode SessionsClient.stopSession saat pengguna mengakhiri aktivitas kebugaran.

4. Berhenti berlangganan dari data kebugaran yang tidak lagi Anda minati menggunakan metode RecordingClient.unsubscribe.

Mulai sesi

Untuk memulai sesi di aplikasi Anda, gunakan metode 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));

Menghentikan sesi

Untuk menghentikan sesi di aplikasi Anda, gunakan metode 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));

Sesi yang dihasilkan memiliki parameter berikut:

• Waktu mulai: Waktu saat aplikasi Anda memanggil metode SessionsClient.startSession.

• Waktu berakhir: Waktu saat aplikasi Anda memanggil metode SessionsClient.stopSession.

• Nama: Nama dalam objek Session yang Anda teruskan ke SessionsClient.startSession.

Menyisipkan sesi di toko kebugaran

Untuk menyisipkan sesi dengan data yang sebelumnya Anda kumpulkan, lakukan hal berikut:

1. Buat objek Session yang menentukan interval waktu dan informasi lainnya yang diperlukan.

2. Buat SessionInsertRequest dengan sesi.

3. Secara opsional, tambahkan set data dan gabungkan titik data.

4. Sisipkan sesi menggunakan metode SessionsClient.insertSession.

Sisipkan sesi

Untuk memasukkan data kebugaran yang berisi metadata sesi ke dalam histori kebugaran pengguna, pertama-tama buat instance 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();

Class SessionInsertRequest menyediakan metode praktis untuk menyisipkan data ke dalam histori kebugaran dan membuat sesi dalam panggilan yang sama ke SessionsClient.insertSession. Set data, jika ada, disisipkan seolah-olah Anda telah memanggil metode HistoryClient.insertData terlebih dahulu, lalu sesi dibuat.

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));

Menyisipkan segmen aktivitas

Data segmen aktivitas di Google Fit menunjukkan aktivitas aktivitas kebugaran yang dilakukan pengguna selama interval waktu tertentu. Data segmen aktivitas berjenis com.google.activity.segment (TYPE_ACTIVITY_SEGMENT) dan sangat berguna untuk mendukung jeda selama olahraga.

Misalnya, jika Anda membuat sesi lari 30 menit dengan metode Session.Builder.setActivity(), tetapi pengguna mengambil istirahat 10 menit di antaranya, aplikasi Anda akan secara tidak benar menunjukkan bahwa pengguna berjalan selama 30 menit. Asalkan aplikasi Anda dapat mendeteksi apakah pengguna berjalan atau berjalan, data segmen aktivitas memungkinkan aplikasi Anda menunjukkan bahwa pengguna berlari selama 10 menit, berjalan selama 10 menit, lalu berlari selama 10 menit lagi. Aplikasi lain juga dapat melaporkan aktivitas dengan benar dengan melihat data segmen aktivitas yang Anda sisipkan.

Untuk menambahkan data segmen aktivitas ke sesi, buat set data yang berisi titik-titik jenis com.google.activity.segment. Setiap titik ini mewakili interval waktu berkelanjutan selama pengguna melakukan satu jenis aktivitas.

Contoh berlari dan berjalan sebelumnya akan membutuhkan tiga titik segmen aktivitas: satu untuk berlari selama 10 menit pertama, satu untuk berjalan selama 10 menit berikutnya, dan satu untuk berlari selama 10 menit terakhir.

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();

Baca data kebugaran menggunakan sesi

Sessions API memungkinkan Anda memperoleh daftar sesi dari penyimpanan kebugaran yang cocok dengan beberapa kriteria. Misalnya, Anda bisa mendapatkan semua sesi yang terdapat dalam interval waktu, atau mendapatkan sesi tertentu berdasarkan nama atau ID. Anda juga dapat menentukan apakah Anda tertarik dengan sesi yang dibuat oleh aplikasi Anda atau oleh aplikasi apa pun.

Catatan: Saat membaca sesi yang dibuat oleh aplikasi lain, Anda disarankan untuk menunjukkan kepada pengguna aplikasi mana yang berkontribusi pada sesi tersebut sehingga pengguna mengetahui asal data tersebut. Anda dapat memperoleh nama dan ikon aplikasi yang berkontribusi, bersama dengan intent untuk meluncurkan aplikasi, seperti yang dijelaskan dalam Atribusi Data.

Untuk mendapatkan daftar sesi yang cocok dengan beberapa kriteria, pertama-tama buat instance 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();

Lalu gunakan metode 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));

Baca data tidur menggunakan sesi

Sesi tidur diperlakukan berbeda dari sesi aktivitas lainnya. Secara default, respons baca hanya berisi sesi aktivitas, bukan sesi tidur.

Untuk menyertakan sesi tidur, gunakan metode includeSleepSessions saat Anda membuat SessionReadRequest. Untuk menyertakan aktivitas dan sesi, gunakan includeSleepSessions dan includeActivitySessions.

Tampilkan sesi di aplikasi lain

Untuk menampilkan tampilan sesi yang lebih mendetail kepada pengguna di aplikasi lain, aplikasi Anda dapat memanggil intent yang berisi informasi sesi. Anda dapat menentukan aplikasi tertentu, seperti aplikasi yang membuat sesi. Atau, jika aplikasi yang membuat sesi tidak diinstal di perangkat, Anda dapat mengizinkan aplikasi apa pun yang dapat menampilkan aktivitas kebugaran untuk merespons intent tersebut.

Untuk membuat intent guna menampilkan data sesi di aplikasi yang berbeda, gunakan class 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);

Menerima intent dari aplikasi lain

Untuk mendaftarkan aplikasi Anda guna menerima intent dari aplikasi kesehatan dan kebugaran lainnya, deklarasikan filter intent dalam manifes Anda yang mirip dengan berikut ini:

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

Catatan: Jangan sertakan kategori DEFAULT dalam filter intent, kecuali jika Anda ingin aplikasi menerima intent untuk sesi yang dibuat oleh aplikasi lain.

Setiap intent yang diterima aplikasi Anda dari Google Fit hanya terdiri dari satu aktivitas, tetapi Anda dapat memfilter beberapa jenis MIME dalam satu filter intent. Filter intent aplikasi Anda perlu menyertakan semua aktivitas yang didukung aplikasi Anda.

Intent kebugaran mencakup tambahan berikut:

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

Anda bisa mendapatkan data dari tambahan ini sebagai berikut:

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());
    }
}