pdf-icon

Arduino Guide

1. Arduino Setup

1. Arduino IDE
2. Arduino Board Manager
3. Arduino Library

2. API & Examples

M5Tough

Touch

M5NanoC6

RGB LED

3. M5Unified

4. M5GFX

M5GFX API
M5GFX Canvas
M5GFX Button
M5GFX Functions
M5GFX Appendix

扬声器🔉

类名: Speaker

begin()

功能说明:

初始化扬声器

函数原型:

void begin()

注意:
1.如果您不想使用M5.begin() 初始化扬声器, 请在使用扬声器之前调用此函数

案例程序:

#include <M5Stack.h>

void setup(){
  M5.Speaker.begin(); //初始化扬声器
  M5.Speaker.tone(661, 1000);    //设定喇叭以661Hz频率响1000ms
}

void loop(){
  M5.Speaker.update();
  delay(100);
}

end()

功能说明:

停止扬声器

函数原型:

void end()

案例程序:

#include <M5Stack.h>

void setup(){
  M5.begin();
}

void loop(){
  M5.update();
  if(M5.BtnA.wasPressed()) {  //如果按键A被按下
    M5.Speaker.tone(661); //设定喇叭以661Hz频率持续响
  }else if(M5.BtnB.wasPressed()){
    M5.Speaker.end(); //关闭扬声器
  }
  delay(100);
}

update()

功能说明:

将扬声器的设置输出

函数原型:

void update()

注意:
需结合发声函数使用, 才能使M5Core发出声音

案例程序:

#include <M5Stack.h>

void setup(){
  M5.Speaker.begin(); //初始化扬声器
  M5.Speaker.tone(661, 1000);    //设定喇叭以661Hz频率响1000ms
}

void loop(){
  M5.Speaker.update();
  delay(100);
}

tone()

功能说明:

设定喇叭以频率frequency持续响 / (响duration毫秒)

函数原型:

void tone(uint16_t frequency)

void tone(uint16_t frequency, uint32_t duration)

参数 类型 描述
frequency uint16_t 扬声器频率
duration uint32_t 响的时间(毫秒)

案例程序:

#include <M5Stack.h>

void setup(){
  M5.begin();
}

void loop(){
  M5.update();
  if(M5.BtnA.wasPressed()) {  //如果按键A被按下
    M5.Speaker.tone(661, 200); //设定喇叭以661Hz频率响200ms
  }else if(M5.BtnB.wasPressed()){
    M5.Speaker.tone(112); //设定喇叭以112Hz频率持续响
  }else if(M5.BtnC.wasPressed()){
    M5.Speaker.end(); //关闭喇叭
  }
  delay(100);
}

setVolume()

功能说明:

设置音量

函数原型:

void setVolume(uint8_t volume)

参数 类型 描述
volume uint8_t 音量(0~11)

案例程序:

#include <M5Stack.h>
char i = 0;
void setup(){
  M5.begin();
  M5.Speaker.begin();
}

void loop(){
  M5.update();
  if(M5.BtnA.wasPressed()) {  //如果按键A被按下
    M5.Speaker.tone(661, 200); //设定喇叭以661Hz频率响200ms
  }else if(M5.BtnC.wasPressed()){
    M5.Speaker.setVolume(i++); //设置扬声器音量
  }
  delay(100);
}
On This Page