... | ... | @@ -74,12 +74,18 @@ B4S can relate beacon interactions to individual customers. Supplying the custom |
|
|
|
|
|
### Deep linking
|
|
|
|
|
|
Notifications such as web links or simple messages are handled directly by the SDK. For deep linking, there are three options, which can be set using `NotificationService.registerDeepLinkStyle(NotificationService.DeepLinkStyle)`:
|
|
|
Notifications such as web links or simple messages are handled directly by the SDK. For deep linking, there are three options:
|
|
|
|
|
|
- `DeepLinkStyle.LaunchActivityClearTask` - (Default) Deep links are delivered to your launch Activity, and always in a new task (with an Activity restart)
|
|
|
- `DeepLinkStyle.LaunchActivityDirect` - Deep links are delivered to your launch Activity; if this is already running the Intent is delivered directly to your `onNewIntent` lifecycle method
|
|
|
- `DeepLinkStyle.BroadcastReceiver` - Deep links are broadcasted with a `com.ezeeworld.b4s.android.sdk.notifications.DEEP_LINK` Intent action type
|
|
|
|
|
|
The strategy can be set by calling a static method, typically after you have initialized the SDK in your `Application` class:
|
|
|
|
|
|
```java
|
|
|
NotificationService.registerDeepLinkStyle(NotificationService.DeepLinkStyle deepLinkStyle);
|
|
|
```
|
|
|
|
|
|
When you configure to use `DeepLinkStyle.BroadcastReceiver` deep links, the application can and must register a `BroadcastReceiver` that handles the deep links, such as opening a specific Activity or starting a Service. In your `AndroidManifest.xml` you declare:
|
|
|
|
|
|
```xml
|
... | ... | @@ -132,4 +138,4 @@ It is recommended to call these from the `Application`'s 'onCreate` method, but |
|
|
|
|
|
With Android 6.0 (API level 23) a new permission system was introduced by Google. On Android 6 devices, users can manually manage permissions on a per-application basis. If an app targets Android 6 (using targetSdkVersion 23 and compileSdkVersion 23), an app also needs to deal with runtime permissions. This means that permissions such as location access (which is now a so-called 'dangerous' permission) needs to be explicitly requested with a permission request pop-up. Until SDK version 1.4.2, the B4S SDK does not handle this automatically and therefor the integrator needs to [handle permission request dialogs manually](https://developer.android.com/training/permissions/requesting.html).
|
|
|
|
|
|
From version 1.5.0 onwards this will be handled for you by the SDK. A request to access the user location will automatically be shown when access was not yet granted. It is important to note that this affects any application when running on an Android 6 device, even those that still target API level 22 or lower. |
|
|
From version 1.5.0 onwards this will be handled for you by the SDK. A request to access the user location will automatically be shown when access was not yet granted. It is important to note that this affects any application when running on an Android 6 device, even those that still target API level 22 or lower. |
|
|
\ No newline at end of file |