Bixby Developer Center

Guides

Refreshing Content

This sample capsule demonstrates how to implement a refresh use case, using a ride sharing capsule as an example.

Download Capsule

Note

Because you cannot submit a capsule with the example namespace, in order to test a sample capsule on a device, you must change the id in the capsule.bxb file from example to your organization's before making a private submission.

For example, if your namespace is acme, change example.refresh to acme.refresh.

Refreshes are especially useful when updating a user on the current status of an activity, such as the location of a user's last order. In this particular sample, the ride share capsule uses the goal: CheckRideShareStatus as the intent. The UI then periodically refreshes to show how far away the current ride is, with an updated message for the user each time it's refreshed.

The refresh is implemented in the result-view, refreshing the interface at five second intervals:

refresh {
if (this.countdown != 0) {
spec {
delay-seconds (5)
with-request {
intent {
goal: CheckRideShareStatus
value {
$expr (this)
}
}
}
}
}
}

For more information, see Refreshing Your Content.