How to Use Q1 Buttons in Applications: Difference between revisions

From wizarPOS
No edit summary
(Replaced content with "{{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/utilize-q1-buttons}}")
Tag: Replaced
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
== Keyboard Description ==
{{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/utilize-q1-buttons}}
{| class="wikitable"
|-
! 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
|-
| Scann|| 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>
      <!-- 设置当有人按下scan按键后调用扫描应用 -->
      <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.
<syntaxhighlight lang="java">
/** 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);
}
 
</syntaxhighlight >

Latest revision as of 08:39, 7 April 2024

Please visit new link of same subject:

https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/utilize-q1-buttons

We're making a move! Our site's content is migrating to a new URL, to provide you with an enhanced browsing experience. Please update your bookmarks accordingly. Thank you for your continuous support!