Bixby Developer Center

Guides
References

permission-link

optionalmultiple allowed

Creates a clickable component that asks users to grant a requested permission if it was previously denied. If the component is tapped, the permission is re-prompted to be granted.

You can ask users for a library-permission or device-location-access. You can only ask for one permission in this component. The permission asked for must also be declared in the capsule.bxb file. For more information on how to request for permissions, see Grant Capsule Permissions in the Setting Up Your Capsule topic.

If a user agrees, that permission will be granted to Bixby and the on-allow intent can execute. If a user disagrees, then the permission is not granted and Bixby will continue to execute as if it didn't have the permission and users return to the view where they tapped the permission-link. You can alternatively pass a different intent back with the on-deny key.

Example

input-view {
match: ...
render {
layout {
section {
content {
permission-link {
text (Provide location access for better results) // required
device-location-access
on-allow { // required
intent {
goal {
myRadioPlayer.PlayRadio @context (Outer)
}
value {
myRadioPlayer.PlayRadio.Local (true)
}
}
}
on-deny { // optional
intent {
goal {
myRadioPlayer.PlayRadio @context (Outer)
}
value {
myRadioPlayer.PlayRadio.Local (false)
}
}
}
}
}
}
}
}
}

Here is what the component looks like when asking for the user's location:

Permission link

Child Keys

on-allow
required
Determines the intent to be passed back to Bixby if the user grants the requested permission in the permission-link component
text
required
Text describing the permission being requested
device-location-access
optional
Specifies that you are requesting device-location-access in the permission-link component
library-permission
optional
Specifies that you are requesting a library-permission in the permission-link component
on-deny
optional
Determines the intent to be passed back to Bixby if the user rejects the requested permission in the permission-link component