How to Use Q1 Buttons in Applications - Revision history

Mahong: Replaced content with "{{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/utilize-q1-buttons}}"

2024-04-07T08:39:06Z

Replaced content with "{{Migrating|https://smartpossdk.gitbook.io/cloudpossdk/faq/firmware/utilize-q1-buttons}}"

← Older revision		Revision as of 08:39, 7 April 2024
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~~
	\|-
	~~\| 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>~~
	~~<!-- 设置当有人按下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 >~~

Simon no use at 05:14, 28 December 2023

2023-12-28T05:14:29Z

← Older revision		Revision as of 05:14, 28 December 2023
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

Simon no use: Simon moved page How to use the buttons of Q1 in the application to How to Use Q1 Buttons in Applications: Normalize the title

2023-12-27T17:24:43Z

Simon moved page How to use the buttons of Q1 in the application to How to Use Q1 Buttons in Applications: Normalize the title

← Older revision	Revision as of 17:24, 27 December 2023
(No difference)

Simon no use at 17:22, 27 December 2023

2023-12-27T17:22:58Z

← Older revision		Revision as of 17:22, 27 December 2023
Line 1:		Line 1:
	== Keyboard ~~description~~ ==		== Keyboard Description ==
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! Key!! Value!! Description		! Key!! Value!! Description
	\|-		\|-
	\| Period \|\| KeyEvent.KEYCODE_PERIOD \|\| ~~The black~~ dot button on the right-bottom of keyboard.		\| Period \|\| KeyEvent.KEYCODE_PERIOD \|\| Black dot button on the right-bottom of the keyboard
	\|-		\|-
	\| QRCode\|\| 232 \|\| ~~The orange~~ button on the middle-bottom of keyboard		\| QRCode\|\| 232 \|\| Orange button on the middle-bottom of the keyboard
	\|-		\|-
	\| Back\|\| KeyEvent.KEYCODE_ESCAPE\|\| ~~The red~~ X button on the left-bottom of keyboard		\| Back\|\| KeyEvent.KEYCODE_ESCAPE\|\| Red 'X' button on the left-bottom of the keyboard
	\|-		\|-
	\| Scann\|\| 229\|\| ~~The orange~~ button on the left of the ~~LED~~		\| Scann\|\| 229\|\| Orange button on the left of the LCD
	\|-		\|-
	\| Delete\|\| KeyEvent.KEYCODE_DEL\|\| ~~The yellow~~ triangle button on the right-top of keyboard		\| Delete\|\| KeyEvent.KEYCODE_DEL\|\| Yellow triangle button on the right-top of the keyboard
	\|-		\|-
	\| Enter\|\| KeyEvent.KEYCODE_ENTER\|\| ~~The green~~ circle button on the right-bottom of keyboard		\| Enter\|\| KeyEvent.KEYCODE_ENTER\|\| Green circle button on the right-bottom of the keyboard
	\|}		\|}
	~~The others~~ are digital buttons ~~which are~~ defined in ~~the Android system. See~~ android.view.KeyEvent.		Digital Buttons: Other buttons are standard digital buttons as defined in android.view.KeyEvent.
			== Scan Button and QR Code Button Usage ==
	== Scan ~~button~~ and QR Code ~~button~~ ==		* '''Function:''' These buttons quickly launch scan applications.
	~~The scan button and QR code button can~~ quickly launch ~~the~~ scan ~~application~~. ~~If you press one of the buttons,~~ the system ~~will~~ search for ~~all the~~ applications ~~installed in the system and will launch the application~~ with ~~the~~ scan intent-filter. If ~~there~~ are ~~many applications~~, the system ~~will provide~~ a list for ~~users to choose, and the~~ selected application will start. The code for the scan intent-filter is as follows:		* '''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" />		<action android:name="android.intent.action.SCAN" />
	<category android:name="android.intent.category.DEFAULT" />		<category android:name="android.intent.category.DEFAULT" />
	~~When there is~~ no application ~~in the system to define~~ the scan intent-filter, pressing ~~the scan button or QR code button will not work~~.		* '''Note:''' If no application with the scan intent-filter is installed, pressing these buttons has no effect.
	==~~= Sample =~~==		== Implementation in Applications ==
	~~There are two ways to~~ use the scan button and the QR code button:		1. '''Defining Intent-Filter:'''
	* In order to use the scan button to quickly launch the scan application, ~~the~~ application must define ~~the~~ scan intent-filter in ~~its~~ Android manifest file. ~~The~~ category and ~~the~~ action ~~are defined as follows:~~		* 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		<activity
	android:name="com.XX.activity.MainActivity"		android:name="com.XX.activity.MainActivity"
Line 35:		Line 39:
	</intent-filter>		</intent-filter>
	</activity>		</activity>
			2. '''Handling Button Press:'''
	* When the button is pressed, the active top task ~~gets~~ the key value ~~and executes it as its logical source code~~. ~~The~~ application ~~must~~ override ~~the function of onKeyDown as follows:~~		* 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">		<syntaxhighlight lang="java">
	/** Key code constant: left scan key. */		/** Key code constant: left scan key. */

Jeff nouse: /* Sample */

2020-03-26T04:30:26Z

Sample

← Older revision		Revision as of 04:30, 26 March 2020
Line 36:		Line 36:
	</activity>		</activity>

	* When the button is pressed, the active top task gets the key value and executes it as its logical source code. The application must override the function of ~~onkeydown~~ as follows:		* When the button is pressed, the active top task gets the key value and executes it as its logical source code. The application must override the function of onKeyDown as follows:
	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	/** Key code constant: left scan key. */		/** Key code constant: left scan key. */

Jeff nouse: /* Sample */

2020-03-26T04:29:41Z

Sample

← Older revision		Revision as of 04:29, 26 March 2020
Line 36:		Line 36:
	</activity>		</activity>

	* ~~Use like~~ the ~~other keys~~, ~~when press~~ the ~~key , the activated and~~ top task ~~will get~~ the key value and do as its ~~logic~~ source code. ~~Firstly the~~ application must override the function of ~~onKeydown,~~ as follows:		* When the button is pressed, the active top task gets the key value and executes it as its logical source code. The application must override the function of onkeydown as follows:
	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	/** Key code constant: left scan key. */		/** Key code constant: left scan key. */

Jeff nouse: /* Sample */

2020-03-26T04:20:35Z

Sample

← Older revision		Revision as of 04:20, 26 March 2020
Line 24:		Line 24:
	When there is no application in the system to define the scan intent-filter, pressing the scan button or QR code button will not work.		When there is no application in the system to define the scan intent-filter, pressing the scan button or QR code button will not work.
	=== Sample ===		=== Sample ===
	There are two ways to use the ~~Scanner Key~~ and the ~~QRCode Key~~:		There are two ways to use the scan button and the QR code button:
	* ~~To start scanner~~ application ~~quickly. The~~ application must define the intent-filter ~~of scanner~~ in ~~its’ android~~ manifest file~~, the~~ category and the action ~~definition~~ are as ~~below~~:		* In order to use the scan button to quickly launch the scan application, the application must define the scan intent-filter in its Android manifest file. The category and the action are defined as follows:
	<activity		<activity
	android:name="com.XX.activity.MainActivity"		android:name="com.XX.activity.MainActivity"

Jeff nouse: /* Scan button and QR Code button */

2020-03-26T04:11:22Z

Scan button and QR Code button

← Older revision		Revision as of 04:11, 26 March 2020
Line 18:		Line 18:
	The others are digital buttons which are defined in the Android system. See android.view.KeyEvent.		The others are digital buttons which are defined in the Android system. See android.view.KeyEvent.

	== Scan button and QR Code button==		== Scan button and QR Code button ==
	~~=== Use Specification =~~==		The scan button and QR code button can quickly launch the scan application. If you press one of the buttons, the system will search for all the applications installed in the system and will launch the application with the scan intent-filter. If there are many applications, the system will provide a list for users to choose, and the selected application will start. The code for the scan intent-filter is as follows:
	The ~~Scanner Key~~ and ~~the QRCode Key~~ can ~~start~~ the ~~scanner~~ application ~~quickly~~. If one of the ~~keys is pressed~~, the system will search all the applications installed in the system, the ~~applications~~ with the intent-filter ~~of scanner will be started~~. If there are many applications, the system will provide a list for ~~the user~~ to ~~select~~, the selected will be start, The ~~contents in~~ the intent-filter ~~of scanner are~~ as follows:
	<action android:name="android.intent.action.SCAN" />		<action android:name="android.intent.action.SCAN" />
	<category android:name="android.intent.category.DEFAULT" />		<category android:name="android.intent.category.DEFAULT" />
	~~Press the Scanner Key or the QRCode Key will not effect when none of the applications~~ in the system ~~defines~~ the intent-filter ~~of scanner~~.		When there is no application in the system to define the scan intent-filter, pressing the scan button or QR code button will not work.
	=== Sample ===		=== Sample ===
	There are two ways to use the Scanner Key and the QRCode Key:		There are two ways to use the Scanner Key and the QRCode Key:

Jeff nouse: /* Scanner Key or QRCode Key */

2020-03-26T04:00:19Z

Scanner Key or QRCode Key

← Older revision		Revision as of 04:00, 26 March 2020
Line 18:		Line 18:
	The others are digital buttons which are defined in the Android system. See android.view.KeyEvent.		The others are digital buttons which are defined in the Android system. See android.view.KeyEvent.

	== ~~Scanner Key or QRCode Key~~==		== Scan button and QR Code button==
	=== Use Specification ===		=== Use Specification ===
	The Scanner Key and the QRCode Key can start the scanner application quickly. If one of the keys is pressed, the system will search all the applications installed in the system, the applications with the intent-filter of scanner will be started. If there are many applications, the system will provide a list for the user to select, the selected will be start, The contents in the intent-filter of scanner are as follows:		The Scanner Key and the QRCode Key can start the scanner application quickly. If one of the keys is pressed, the system will search all the applications installed in the system, the applications with the intent-filter of scanner will be started. If there are many applications, the system will provide a list for the user to select, the selected will be start, The contents in the intent-filter of scanner are as follows:

Jeff nouse: /* Keyboard description */

2020-03-26T01:14:30Z

Keyboard description

← Older revision		Revision as of 01:14, 26 March 2020
Line 4:		Line 4:
	! Key!! Value!! Description		! Key!! Value!! Description
	\|-		\|-
	\| Period \|\| KeyEvent.KEYCODE_PERIOD \|\| The black dot ~~key~~ on the right-bottom of keyboard.		\| Period \|\| KeyEvent.KEYCODE_PERIOD \|\| The black dot button on the right-bottom of keyboard.
	\|-		\|-
	\| QRCode\|\| 232 \|\| The orange ~~key~~ on the middle-bottom of keyboard		\| QRCode\|\| 232 \|\| The orange button on the middle-bottom of keyboard
	\|-		\|-
	\| Back\|\| KeyEvent.KEYCODE_ESCAPE\|\| The red X ~~key~~ on the left-bottom of keyboard		\| Back\|\| KeyEvent.KEYCODE_ESCAPE\|\| The red X button on the left-bottom of keyboard
	\|-		\|-
	\| ~~Scanner~~\|\| 229\|\| The orange ~~key~~ on the left of the LED		\| Scann\|\| 229\|\| The orange button on the left of the LED
	\|-		\|-
	\| Delete\|\| KeyEvent.KEYCODE_DEL\|\| The yellow triangle ~~key~~ on the right-top of keyboard		\| Delete\|\| KeyEvent.KEYCODE_DEL\|\| The yellow triangle button on the right-top of keyboard
	\|-		\|-
	\| Enter\|\| KeyEvent.KEYCODE_ENTER\|\| The green circle ~~key~~ on the right-bottom of keyboard		\| Enter\|\| KeyEvent.KEYCODE_ENTER\|\| The green circle button on the right-bottom of keyboard
	\|}		\|}
	The others are digital ~~keys~~ which are defined in the Android system. See android.view.KeyEvent.		The others are digital buttons which are defined in the Android system. See android.view.KeyEvent.

	== Scanner Key or QRCode Key==		== Scanner Key or QRCode Key==