http:///https//wiki.microduino.cn/index.php?action=history&feed=atom&title=Key.readVal%28%29
Key.readVal() - 版本历史
2026-04-29T18:14:14Z
本wiki的该页面的版本历史
MediaWiki 1.30.0
https//wiki.microduino.cn/index.php?title=Key.readVal()&diff=21721&oldid=prev
Yanglibin@microduino.cc：创建页面，内容为“{| style="width: 800px;" |- | 用来检测数字开关、模拟开关、虚拟开关【释放】【按下】动作及状态。 <p style="color: #666666;font-size:145...”
2017-07-19T08:10:38Z
<p>创建页面，内容为“{| style="width: 800px;" |- | 用来检测数字开关、模拟开关、虚拟开关【释放】【按下】动作及状态。 <p style="color: #666666;font-size:145...”</p>
<p><b>新页面</b></p><div>{| style="width: 800px;"<br />
|-<br />
|<br />
用来检测数字开关、模拟开关、虚拟开关【释放】【按下】动作及状态。<br />
<p style="color: #666666;font-size:145%">'''数字开关：Key. readVal()'''</p><br />
<p style="color: #E87E05;font-size:135%">描述</p><br />
识别数字传感器的【释放】【按下】动作及状态。数字开关必须结合<big>[[DigitalKey()]]</big>结构体来使用。<br />
<p style="color: #E87E05;font-size:135%">参数</p><br />
无<br />
<p style="color: #E87E05;font-size:135%">返回值</p><br />
uint8_t类型。<br />
*释放状态：<code style="color: #E87E05">KEY_RELEASED</code><br />
*按下状态：<code style="color: #E87E05">KEY_PRESSED</code><br />
*释放动作：<code style="color: #E87E05">KEY_RELEASING</code><br />
*按下动作：<code style="color: #E87E05">KEY_PRESSING</code><br />
<br><br />
<br><br />
<p style="color: #666666;font-size:145%">'''模拟开关：Key. readVal(MIN,MAX)'''</p><br />
<p style="color: #E87E05;font-size:135%">描述</p><br />
识别模拟传感器对应区间的【释放】【按下】动作及状态。模拟开关必须结合<big>[[AnalogKey()]]</big>结构体来使用。<br />
<p style="color: #E87E05;font-size:135%">参数</p><br />
*'''MIN'''：模拟区间最小值；<br />
*'''MAX'''：模拟区间最大值；<br />
<p style="color: #E87E05;font-size:135%">返回值</p><br />
uint8_t类型。<br />
*释放状态：<code style="color: #E87E05">KEY_RELEASED</code><br />
*按下状态：<code style="color: #E87E05">KEY_PRESSED</code><br />
*释放动作：<code style="color: #E87E05">KEY_RELEASING</code><br />
*按下动作：<code style="color: #E87E05">KEY_PRESSING</code><br />
<br><br />
<br><br />
<p style="color: #666666;font-size:145%">'''虚拟开关：Key. readVal(bool)'''</p><br />
<p style="color: #E87E05;font-size:135%">描述</p><br />
识别虚拟开关对应状态的【释放】【按下】动作及状态。虚拟开关必须结合<big>[[VirtualKey()]]</big>结构体来使用。<br />
<p style="color: #E87E05;font-size:135%">参数</p><br />
*'''bool'''：虚拟开关的真假值；<br />
<p style="color: #E87E05;font-size:135%">返回值</p><br />
uint8_t类型。<br />
*释放状态：<code style="color: #E87E05">KEY_RELEASED</code><br />
*按下状态：<code style="color: #E87E05">KEY_PRESSED</code><br />
*释放动作：<code style="color: #E87E05">KEY_RELEASING</code><br />
*按下动作：<code style="color: #E87E05">KEY_PRESSING</code><br />
<br><br />
<br><br />
<p style="color: #E87E05;font-size:135%">示例</p><br />
*识别模拟传感器对应区间的【长按】【短按】动作<br />
<source lang="c++"><br />
#include <Microduino_Key.h><br />
<br />
AnalogKey keyAnalog(A0);<br />
<br />
void setup() {<br />
Serial.begin(9600);<br />
keyAnalog.begin(INPUT);<br />
}<br />
<br />
void loop() {<br />
switch (keyAnalog.readVal(0, 50)) { //(模拟最小值,模拟最大值)<br />
case KEY_RELEASED:<br />
Serial.println("KEY (analog) RELEASED---1"); //按键释放状态<br />
break;<br />
case KEY_PRESSED:<br />
Serial.println("KEY (analog) PRESSED-------2"); //按键按下状态<br />
break;<br />
case KEY_PRESSING:<br />
Serial.println("KEY (analog) PRESSING--------3"); //按键按下动作<br />
break;<br />
case KEY_RELEASING:<br />
Serial.println("KEY (analog) RELEASING---------4"); //按键释放动作<br />
break;<br />
}<br />
<br />
delay(100);<br />
}<br />
</source><br />
<br><br />
*识别数字传感器对应区间的【长按】【短按】动作<br />
<source lang="c++"><br />
#include <Microduino_Key.h><br />
<br />
DigitalKey keyDigital(A0);<br />
<br />
void setup() {<br />
Serial.begin(9600);<br />
keyDigital.begin(INPUT_PULLUP);<br />
}<br />
<br />
void loop() {<br />
switch (keyDigital.readVal()) {<br />
case KEY_RELEASED:<br />
Serial.println("KEY (digital) RELEASED---1"); //按键释放状态<br />
break;<br />
case KEY_PRESSED:<br />
Serial.println("KEY (digital) PRESSED-------2"); //按键按下状态<br />
break;<br />
case KEY_PRESSING:<br />
Serial.println("KEY (digital) PRESSING--------3"); //按键按下动作<br />
break;<br />
case KEY_RELEASING:<br />
Serial.println("KEY (digital) RELEASING---------4"); //按键释放动作<br />
break;<br />
}<br />
<br />
delay(100);<br />
}<br />
</source><br />
<br><br />
*识别虚拟开关对应状态的【长按】【短按】动作<br />
<source lang="c++"><br />
#include <Microduino_Key.h><br />
<br />
VirtualKey keyVirtual;<br />
<br />
void setup() {<br />
Serial.begin(9600);<br />
keyVirtual.begin();<br />
pinMode(A0, INPUT_PULLUP);<br />
}<br />
<br />
void loop() {<br />
bool val = !digitalRead(A0); //val 可以是任何bool变量<br />
switch (keyVirtual.readVal(val)) {<br />
case KEY_RELEASED:<br />
Serial.println("KEY (digital) RELEASED---1"); //按键释放状态<br />
break;<br />
case KEY_PRESSED:<br />
Serial.println("KEY (digital) PRESSED-------2"); //按键按下状态<br />
break;<br />
case KEY_PRESSING:<br />
Serial.println("KEY (digital) PRESSING--------3"); //按键按下动作<br />
break;<br />
case KEY_RELEASING:<br />
Serial.println("KEY (digital) RELEASING---------4"); //按键释放动作<br />
break;<br />
}<br />
<br />
delay(100);<br />
}<br />
</source><br />
<p style="color: #E87E05;font-size:135%">其他</p><br />
*[[AnalogKey()]]<br />
*[[DigitalKey()]]<br />
*[[VirtualKey()]]<br />
*[[key.begin()|begin()]]<br />
*[[key.readEvent()| readEvent()]]<br />
|}<br />
<br><br />
<br><br />
<p style="font-size:115%">[[Sensor_Key_Reference|返回Sensor_Key_Reference界面]]</p></div>
Yanglibin@microduino.cc