How to Use Q1 Buttons in Applications: Difference between revisions

From wizarPOS
No edit summary
Line 10: Line 10:
| Back|| KeyEvent.KEYCODE_ESCAPE|| Red 'X' button on the left-bottom of the keyboard
| Back|| KeyEvent.KEYCODE_ESCAPE|| Red 'X' button on the left-bottom of the keyboard
|-
|-
| Scann|| 229|| Orange button on the left of the LCD
| Scan|| 229|| Orange button on the left of the LCD
|-
|-
| Delete|| KeyEvent.KEYCODE_DEL|| Yellow triangle button on the right-top of the keyboard
| Delete|| KeyEvent.KEYCODE_DEL|| Yellow triangle button on the right-top of the keyboard

Revision as of 05:14, 28 December 2023

Keyboard Description

Key Value Description
Period KeyEvent.KEYCODE_PERIOD Black dot button on the right-bottom of the keyboard
QRCode 232 Orange button on the middle-bottom of the keyboard
Back KeyEvent.KEYCODE_ESCAPE Red 'X' button on the left-bottom of the keyboard
Scan 229 Orange button on the left of the LCD
Delete KeyEvent.KEYCODE_DEL Yellow triangle button on the right-top of the keyboard
Enter KeyEvent.KEYCODE_ENTER Green circle button on the right-bottom of the keyboard

Digital Buttons: Other buttons are standard digital buttons as defined in android.view.KeyEvent.

Scan Button and QR Code Button Usage

  • Function: These buttons quickly launch scan applications.
  • Process:
    • Pressing either button prompts the system to search for installed applications with a scan intent-filter.
    • If multiple applications are available, the system displays a list for user selection.
    • The selected application will start. The code for the scan intent-filter is as follows:
   <action android:name="android.intent.action.SCAN" />
   <category android:name="android.intent.category.DEFAULT" />
  • Note: If no application with the scan intent-filter is installed, pressing these buttons has no effect.

Implementation in Applications

1. Defining Intent-Filter:

  • To use the scan button and the QR code button, your application must define a scan intent-filter in the Android manifest file.
  • Specify both the category and action.
   <activity
   android:name="com.XX.activity.MainActivity"
   android:label="@string/app_name" >
    <intent-filter>
      <action android:name="android.intent.action.SCAN" />
      <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
   </activity>

2. Handling Button Press:

  • When the button is pressed, the active top task receives the key value.
  • Implement the logic in the application's 'onKeyDown' function override.
 /** Key code constant: left scan key. */
 public static final int KEYCODE_SCAN_LEFT        	= 229;

 /** Key code constant: right scan key. */
 public static final int KEYCODE_SCAN_RIGHT        = 230;

 /** Key code constant: qr key. */
 public static final int KEYCODE_QR        		= 232;

 public boolean onKeyDown(int keyCode, KeyEvent event) { 
  // listen the key code
  if (keyCode == KEYCODE_SCAN_LEFT|| keyCode ==KEYCODE_SCAN_RIGHT|| keyCode ==KEYCODE_QR) {
  //do something, for example:scanner……
    return true;
  }
  return super.onKeyDown(keyCode, event);
}