Hookswitch-Geräte

Ein Telefongerät kann über mehrere Hookswitchgeräte verfügen. Ein Hookswitch ist der Schalter, der ein Gerät von der Telefonleitung verbindet oder trennt. Auf einem Telefon beispielsweise ist dies der Schalter, der automatisch aktiviert wird, wenn ein Benutzer den Empfänger von der Wiege hebt, um einen neuen Wählton zu erhalten. TAPI definiert drei Arten von Hookswitch-Geräten für ein Telefon: Handset, Freisprecheinrichtung und Headset. Jedes Hookswitchgerät verfügt über einen Lautsprecher und eine Mikrofonkomponente und arbeitet in einem von vier Hookswitchmodi:

• Onhook Das Hookswitchgerät ist onhook, und sowohl das Mikrofon als auch der Lautsprecher sind deaktiviert.
• Mikrofon nur Das Hookswitch-Gerät ist offhook, sein Mikrofon ist aktiviert, und der Lautsprecher ist stummgeschaltet.
• Lautsprecher nur Das Hookswitch-Gerät ist offhook, sein Mikrofon stummgeschaltet und der Lautsprecher ist aktiviert.
• Mikrofon und Lautsprecher Das Hookswitchgerät ist offhook, und sowohl Mikrofon als auch Lautsprecher sind aktiviert.

Die phoneSetHookSwitch--Funktion wird verwendet, um den Hookswitchmodus eines oder mehrerer Hookswitch-Geräte eines offenen Telefongeräts festzulegen. Wenn Sie beispielsweise das Mikrofon oder die Lautsprecherkomponente eines Hookswitchgeräts stummschalten oder aufheben möchten, verwenden Sie phoneSetHookSwitch- mit dem entsprechenden Hookswitchmodus. Die phoneGetHookSwitch--Funktion kann verwendet werden, um den Hookswitchmodus eines Hookswitchgeräts eines offenen Telefongeräts abzufragen.

Wenn der Modus des Hookswitchgeräts eines Telefons manuell geändert wird, z. B. durch Heben des Handsets von der Wiege, wird eine PHONE_STATE Nachricht an die Anwendung gesendet, um die Anwendung über die Zustandsänderung zu benachrichtigen. Parameter für diese Meldung geben einen Hinweis auf die Änderung an.

Die Lautstärke der Lautsprecherkomponente eines Hookswitchgeräts kann mit phoneSetVolume-festgelegt werden. Die Lautstärkeeinstellung unterscheidet sich von der Stummschaltung, bei der das Stummschalten eines Lautsprechers und später die Stummschaltung aufgehoben wird, behält die Lautstärkeeinstellung des Lautsprechers bei. Die phoneGetVolume--Funktion kann verwendet werden, um die aktuelle Lautstärkeeinstellung des Lautsprechers eines Hookswitchgeräts eines offenen Telefongeräts zurückzugeben.

Die Mikrofonkomponente eines Hookswitchgeräts kann auch gesteuert werden. Die Einstellung "Verstärkung" unterscheidet sich von der Stummschaltung, bei der das Stummschalten eines Mikrofons und das spätere Aufheben der Stummschaltung die Verstärkungseinstellung des Mikrofons erhalten bleibt. Verwenden Sie phoneSetGain-, um das Mikrofon eines Hookswitchgeräts eines geöffneten Telefongeräts festzulegen, und phoneGetGain, um die Verstärkungseinstellung des Mikrofons eines Hookswitchgeräts eines geöffneten Telefons zurückzugeben.

Wenn das Volume oder die Gewinnung des Hookswitchgeräts eines Telefons geändert wird, wird eine PHONE_STATE Nachricht an die Anwendungsfunktion gesendet, um die Anwendung über die Zustandsänderung zu benachrichtigen. Parameter für diese Meldung geben einen Hinweis auf die Änderung an.