Bixby Developer Center

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 Developers' Guide. Additionally, you can try the Permissions sample capsule to see how permissions are set up in a capsule.

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.

Interactive Demo

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

Example

input-view {
  match: ...
  render {
    layout {
      section {
        content {
          permission-link {
            text (Customize results based on your profile) // required
            library-permission (self:profile)
            on-allow { // required
              intent {
                goal {
                  myCapsule.MyAction
                }
                value-set: self.RequiredField {
                  self.RequiredField(structuredName)
                }
              }
            }
          }
        }
      }
    }
  }
}