सेशन के साथ काम करें

सेशन उस समयावधि को दिखाते हैं जिस दौरान उपयोगकर्ता कोई फ़िटनेस गतिविधि करते हैं. सेशन एपीआई की मदद से, आपका ऐप्लिकेशन फ़िटनेस स्टोर में.

फ़िटनेस की गतिविधियों के लिए, जिनमें उपयोगकर्ता आपके ऐप्लिकेशन को शुरू करने पर सूचना देता है और फ़िटनेस की गतिविधि पूरी करते हैं, तो रीयल टाइम में सेशन तैयार किए जा सकते हैं.

किसी फ़िटनेस गतिविधि के बाद भी फ़िटनेस स्टोर में कोई सेशन डाली जा सकती है खत्म होता है या जब आप 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) और खास तौर पर, कसरत के दौरान रुकने में मदद करने में मददगार होता है.

उदाहरण के लिए, अगर आपने Session.Builder.setActivity() लेकिन उपयोगकर्ता 10 मिनट का ब्रेक लेता है. इस दौरान आपका ऐप्लिकेशन इसमें गलत तरीके से दिखाया गया है कि उपयोगकर्ता 30 मिनट तक दौड़ा है. बशर्ते आपका ऐप्लिकेशन ये काम कर सके अगर कोई व्यक्ति पैदल चल रहा है या चल रहा है, तो गतिविधि सेगमेंट के डेटा की मदद से ऐप से पता चलता है कि उपयोगकर्ता 10 मिनट तक दौड़ा, 10 मिनट तक चला और फिर दौड़ा 10 मिनट के लिए. अन्य ऐप्लिकेशन भी गतिविधि की सही शिकायत कर सकते हैं जो गतिविधि सेगमेंट का डेटा आपने डाला है उसे देखकर.

किसी सेशन में गतिविधि सेगमेंट का डेटा जोड़ने के लिए, पॉइंट वाला डेटासेट बनाएं com.google.activity.segment टाइप का है. इनमें से हर एक पॉइंट निरंतर समय का अंतराल जिसमें उपयोगकर्ता ने एक ही तरह की गतिविधि की हो.

दौड़ने और पैदल चलने के पिछले उदाहरण में, गतिविधि के तीन सेगमेंट की ज़रूरत होगी अंक: एक पहले 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();

सेशन का इस्तेमाल करके फ़िटनेस का डेटा देखें

सेशन एपीआई की मदद से, ऐसे फ़िटनेस स्टोर से सेशन की सूची ली जा सकती है जिसमें कुछ शर्तों को पूरा करते हैं. उदाहरण के लिए, आपको सभी सेशन समयावधि चुनें या किसी खास सेशन को नाम या आईडी से ऐक्सेस करें. यह भी बताया जा सकता है कि चाहे आपकी दिलचस्पी अपने ऐप्लिकेशन से बनाए गए सेशन में हो या किसी ऐप्लिकेशन के बनाए गए सेशन में.

कुछ शर्तों से मेल खाने वाले सेशन की सूची पाने के लिए, सबसे पहले 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.

अन्य ऐप्लिकेशन में सेशन दिखाएं

उपयोगकर्ताओं को किसी दूसरे ऐप्लिकेशन में किसी खास सेशन का ज़्यादा जानकारी वाला व्यू दिखाने के लिए, आपका ऐप्लिकेशन किसी ऐसे इंटेंट को शुरू कर सकता है जिसमें सेशन की जानकारी हो. आप सेशन शुरू करने वाले ऐप्लिकेशन जैसा कोई खास ऐप्लिकेशन चुनें. या अगर जिस ऐप्लिकेशन की मदद से सेशन बनाया गया है वह डिवाइस पर इंस्टॉल नहीं है. हालांकि, किसी भी ऐप्लिकेशन को ऐप जो इंटेंट को जवाब देने के लिए फ़िटनेस गतिविधि दिखा सकता है.

किसी दूसरे ऐप्लिकेशन पर सेशन का डेटा दिखाने के लिए इंटेंट बनाने के लिए, 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-filter>
    <action android:name="vnd.google.fitness.VIEW"/>
    <data android:mimeType="vnd.google.fitness.session/running"/>
</intent-filter>

'Google फ़िट' से आपके ऐप्लिकेशन को मिलने वाला हर इंटेंट सिर्फ़ एक का होता है ऐक्टिविटी की जानकारी मिलती है, लेकिन एक इंटेंट फ़िल्टर में कई तरह के एमआईएमई टाइप के लिए फ़िल्टर लगाया जा सकता है. आपके ऐप्लिकेशन के इंटेंट फ़िल्टर में, वे सभी गतिविधियां शामिल होनी चाहिए जो आपके ऐप्लिकेशन में मौजूद हैं इस्तेमाल किया जा सकता है.

फ़िटनेस इंटेंट में ये अतिरिक्त सुविधाएं शामिल हैं:

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