Notify (Bluetooth Scanner Notifications)

NOTIFY

Used to play notification sound(s) and/or display a colored LED after a scan from a connected Bluetooth scanner with RSM (Remote Scanner Management). Multiple notifications can be played in succession.

Supported notifications:

• green LED on/off
• red LED on/off
• short/long beep
• fast/slow warble beep
• high/low beep
• low-high beep
• high-low-high beep
• low-high-low beep
• high-high-low-low beep
• multiple beeps in succession, from 1 to 5 times

Supported Bluetooth Scanners with Device Identifiers:

Function Prototype

Bundle bundleNotify = new Bundle();
Bundle bundleNotificationConfig = new Bundle();
i.setAction("com.symbol.datawedge.api.ACTION");

bundleNotificationConfig.putString("DEVICE_IDENTIFIER", <Device Identifier>);
bundleNotificationConfig.putIntArray("NOTIFICATION_SETTINGS", int[]);
bundleNotify.putBundle("NOTIFICATION_CONFIG", bundleNotificationConfig);

i.putExtra("com.symbol.datawedge.api.notification.NOTIFY", bundleNotify);
this.sendBroadcast(i);

Parameters

ACTION [string]: "com.symbol.datawedge.api.ACTION"

EXTRA_DATA [string]: "com.symbol.datawedge.api.notification.NOTIFY"

DEVICE IDENTIFIER [string]: Device identifier of the supported Bluetooth scanner.

NOTIFICATION_SETTINGS [integer]: Integer array of the notification RSM attributes. If multiple attributes are specified, notifications are played one after another in ascending order of the integer array.

Notification RSM attributes for LED/Beep:

• 1 high short beep            0
• 2 high short beeps          1
• 3 high short beeps          2
• 4 high short beeps          3
• 5 high short beeps          4
• 1 low short beep              5
• 2 low short beeps            6
• 3 low short beeps            7
• 4 low short beeps            8
• 5 low short beeps            9
• 1 high long beep              10
• 2 high long beeps            11
• 3 high long beeps            12
• 4 high long beeps            13
• 5 high long beeps            14
• 1 low long beep               15
• 2 low long beeps             16
• 3 low long beeps             17
• 4 low long beeps             18
• 5 low long beeps             19
• Fast warble beep             20
• Slow warble beep            21
• High-low beep                  22
• Low-high beep                  23
• High-low-high beep          24
• Low-high-low beep           25
• High-high-low-low beep   26
• Green LED off                    42
• Green LED on                    43
• Red LED on                        47
• Red LED off                       48

Result Codes

DataWedge returns the following error codes if the app includes the intent extras SEND_RESULT and COMMAND_IDENTIFIER to enable the app to get results using the DataWedge result intent mechanism. See Example, below.

• DATAWEDGE_DISABLED - DataWedge is disabled
• DEVICE_NOT_SUPPORTED - Device does not support notifications
• PARAMETER_INVALID - No values are specified in the RSM attribute array
• DEVICE_NOT_CONNECTED - Scanner is not connected

Example Code

This sample code turns on the red LED and plays 3 low long beeps.

Intent i = new Intent();
Bundle bundleNotify = new Bundle();
Bundle bundleNotificationConfig = new Bundle();
i.setAction("com.symbol.datawedge.api.ACTION");

bundleNotificationConfig.putString("DEVICE_IDENTIFIER", "BLUETOOTH_DS3678");
bundleNotificationConfig.putIntArray("NOTIFICATION_SETTINGS", new int[]{17, 47});
bundleNotify.putBundle("NOTIFICATION_CONFIG", bundleNotificationConfig);

i.putExtra("com.symbol.datawedge.api.notification.NOTIFY", bundleNotify);
this.sendBroadcast(i);

SEE ALSO:

Zebra Support Central | Integrator Guides, Product Manuals, Software Downloads and Support

LaunchPad | Zebra Developer Community

Intent | Android Developers

Intents and Intent Filters | Android Developers

Android Intents | Tutorial