EV3RT C API Reference  V1.0
An RTOS-based development platform for LEGO Mindstorms EV3.
スピーカ

音声(スピーカ)に関するAPI. [詳解]

マクロ定義

#define SOUND_MANUAL_STOP   (-1)
 音声の再生を手動で停止するためのフラグ
 
#define NOTE_C4   (261.63)
 ノートC4の周波数
 
#define NOTE_CS4   (277.18)
 ノートC#4の周波数
 
#define NOTE_D4   (293.66)
 ノートD4の周波数
 
#define NOTE_DS4   (311.13)
 ノートD#4の周波数
 
#define NOTE_E4   (329.63)
 ノートE4の周波数
 
#define NOTE_F4   (349.23)
 ノートF4の周波数
 
#define NOTE_FS4   (369.99)
 ノートF#4の周波数
 
#define NOTE_G4   (392.00)
 ノートG4の周波数
 
#define NOTE_GS4   (415.30)
 ノートG#4の周波数
 
#define NOTE_A4   (440.00)
 ノートA4の周波数
 
#define NOTE_AS4   (466.16)
 ノートA#4の周波数
 
#define NOTE_B4   (493.88)
 ノートB4の周波数
 
#define NOTE_C5   (523.25)
 ノートC5の周波数
 
#define NOTE_CS5   (554.37)
 ノートC#5の周波数
 
#define NOTE_D5   (587.33)
 ノートD5の周波数
 
#define NOTE_DS5   (622.25)
 ノートD#5の周波数
 
#define NOTE_E5   (659.25)
 ノートE5の周波数
 
#define NOTE_F5   (698.46)
 ノートF5の周波数
 
#define NOTE_FS5   (739.99)
 ノートF#5の周波数
 
#define NOTE_G5   (783.99)
 ノートG5の周波数
 
#define NOTE_GS5   (830.61)
 ノートG#5の周波数
 
#define NOTE_A5   (880.00)
 ノートA5の周波数
 
#define NOTE_AS5   (932.33)
 ノートA#5の周波数
 
#define NOTE_B5   (987.77)
 ノートB5の周波数
 
#define NOTE_C6   (1046.50)
 ノートC6の周波数
 
#define NOTE_C6   (1046.50)
 ノートC6の周波数
 
#define NOTE_CS6   (1108.73)
 ノートC#6の周波数
 
#define NOTE_CS6   (1108.73)
 ノートC#6の周波数
 
#define NOTE_D6   (1174.66)
 ノートD6の周波数
 
#define NOTE_D6   (1174.66)
 ノートD6の周波数
 
#define NOTE_DS6   (1244.51)
 ノートD#6の周波数
 
#define NOTE_DS6   (1244.51)
 ノートD#6の周波数
 
#define NOTE_E6   (1318.51)
 ノートE6の周波数
 
#define NOTE_E6   (1318.51)
 ノートE6の周波数
 
#define NOTE_F6   (1396.91)
 ノートF6の周波数
 
#define NOTE_F6   (1396.91)
 ノートF6の周波数
 
#define NOTE_FS6   (1479.98)
 ノートF#6の周波数
 
#define NOTE_FS6   (1479.98)
 ノートF#6の周波数
 
#define NOTE_G6   (1567.98)
 ノートG6の周波数
 
#define NOTE_G6   (1567.98)
 ノートG6の周波数
 
#define NOTE_GS6   (1661.22)
 ノートG#6の周波数
 
#define NOTE_GS6   (1661.22)
 ノートG#6の周波数
 
#define NOTE_A6   (1760.00)
 ノートA6の周波数
 
#define NOTE_A6   (1760.00)
 ノートA6の周波数
 
#define NOTE_AS6   (1864.66)
 ノートA#6の周波数
 
#define NOTE_AS6   (1864.66)
 ノートA#6の周波数
 
#define NOTE_B6   (1975.53)
 ノートB6の周波数
 
#define NOTE_B6   (1975.53)
 ノートB6の周波数
 

関数

ER ev3_speaker_set_volume (uint8_t volume)
 音量を調整する. [詳解]
 
ER ev3_speaker_play_tone (uint16_t frequency, int32_t duration)
 指定した周波数でトーン出力する.今再生しているサウンドは停止される. [詳解]
 
ER ev3_speaker_play_file (const memfile_t *p_memfile, int32_t duration)
 指定したWAVファイル(8-bit 8kHz mono)を再生する.今再生しているサウンドは停止される. [詳解]
 
ER ev3_speaker_stop ()
 今再生しているサウンドを停止する. [詳解]
 

詳解

音声(スピーカ)に関するAPI.

関数詳解

◆ ev3_speaker_play_file()

ER ev3_speaker_play_file ( const memfile_t p_memfile,
int32_t  duration 
)

指定したWAVファイル(8-bit 8kHz mono)を再生する.今再生しているサウンドは停止される.

引数
p_memfileWAVファイルのメモリファイルへのポインタ
duration出力持続時間.単位:ミリ秒.SOUND_MANUAL_STOPを指定した場合は手動で停止しないと最後まで再生する.
戻り値
E_OK正常終了
E_CTX非タスクコンテストから呼び出す
E_NORESサウンドデバイスが占有されている

◆ ev3_speaker_play_tone()

ER ev3_speaker_play_tone ( uint16_t  frequency,
int32_t  duration 
)

指定した周波数でトーン出力する.今再生しているサウンドは停止される.

引数
frequencyトーンの周波数
duration出力持続時間.単位:ミリ秒.SOUND_MANUAL_STOPを指定した場合は手動で停止する.
戻り値
E_OK正常終了
E_CTX非タスクコンテストから呼び出す
E_NORESサウンドデバイスが占有されている

◆ ev3_speaker_set_volume()

ER ev3_speaker_set_volume ( uint8_t  volume)

音量を調整する.

引数
volumeボリュームの値.範囲:0から+100.0はミュート.+100を超えた値を指定すると,実際の値は+100になる.
戻り値
E_OK正常終了
E_CTX非タスクコンテストから呼び出す
E_NORESサウンドデバイスが占有されている

◆ ev3_speaker_stop()

ER ev3_speaker_stop ( )

今再生しているサウンドを停止する.

戻り値
E_OK正常終了
E_CTX非タスクコンテストから呼び出す
E_NORESサウンドデバイスが占有されている