1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
/*
(c) Copyright 2012 - 2026 Anton Sviridenko
https://picapica.im
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#pragma once
#include <QObject>
#include <QVector>
#include <QAtomicInt>
#include <QtGlobal>
#include <QString>
// Simple tone descriptor: frequency in Hz, duration in milliseconds.
struct Tone {
double frequency; // Hz
int duration_ms; // milliseconds
Tone(double f = 0.0, int d = 0): frequency(f), duration_ms(d) {}
};
class TonePlayer : public QObject
{
Q_OBJECT
public:
explicit TonePlayer(QObject *parent = nullptr);
~TonePlayer() override;
// Replace the sequence to play. Call before play().
void setSequence(const QVector<Tone> &sequence);
// Stop playback early. This will cause play() to return.
Q_INVOKABLE void stop();
// Set the platform playback device name (e.g. "default" or "hw:0" on
// ALSA, a CoreAudio/DirectSound device name on macOS/Windows). Default:
// "default". Typically set from the "audio.playback_device" or
// "audio.ring_device" setting (see SettingsDialog). Q_INVOKABLE so it
// can be queued across threads via QMetaObject::invokeMethod(), the
// same way play() is invoked when TonePlayer lives on its own QThread.
Q_INVOKABLE void setDeviceName(const QString &deviceName);
// Set playback parameters (optional before play)
void setSampleRate(int sampleRate);
void setVolume(double vol); // 0.0 .. 1.0
signals:
void finishedPlaying();
void errorOccured(const QString &err);
public slots:
void play();
// Standard telephony tone sequences. Each replaces the current sequence
// and plays it to completion (blocking, like play()).
void playCallInProgress(); // ringing tone: 440 Hz, 1.5 s on / 3 s off, 3 bursts
void playUnreachable(); // special information tone: 950/1400/1800 Hz, 330 ms each
void playBusy(); // busy tone: 440 Hz, 400 ms on / 400 ms off, 3 bursts
void playClassicRingtone(); // electromechanical bell: warbling trill, 2 s on / 4 s off, 3 bursts
private:
// Set the sequence, clear any pending stop request and play it.
void playSequence(const QVector<Tone> &sequence);
// The two ways of getting samples to the speaker, picked apart by
// AudioDevice::PlatformDriverName(PLAYBACK) - see the comment on it.
// Tones always ask for a plain stream rather than a call one: a ringtone
// is not a call, and on macOS asking for the voice processing would open
// the microphone to play it.
void playFFmpeg(const QString &driver);
void playNative(const QString &api);
// Fills out with nb_samples frames of a sine at the tone's frequency
// (silence when it is zero), carrying phase across calls so consecutive
// blocks of one tone do not click at the seam.
void renderBlock(const Tone &t, double &phase, int nb_samples, int channels, qint16 *out);
QVector<Tone> m_sequence;
QAtomicInt m_abort;
QString m_deviceName;
int m_sampleRate;
int m_channels; // always 1 (mono) by design
double m_volume;
};
|
