Gebeurtenisroutering

Met de lineSetTerminal functie kan de toepassing de routering van opgegeven gebeurtenissen op laag niveau (uitgewisseld tussen de switch en het station) naar een apparaat beheren of onderdrukken. Met lineSetTerminalgeeft de toepassing het terminalapparaat op waarnaar deze gebeurtenissen (zoals regel-, adres- of oproepmediastreamgebeurtenissen) worden gerouteerd.

De routering van de verschillende klassen gebeurtenissen kan afzonderlijk worden beheerd, zodat afzonderlijke terminals voor elke gebeurtenisklasse kunnen worden opgegeven. Gebeurtenisklassen zijn lampen, knoppen, display, belsignaal, hookswitch en mediastream.

De mediastroom van een oproep (bijvoorbeeld spraak) kan bijvoorbeeld worden verzonden naar elk transducerapparaat als de serviceprovider en de hardware dit kunnen doen. Over het algemeen betekent een transducer hetzelfde als wat wordt aangeduid als een hookswitch apparaat in TAPI, iets dat een microfoon en een luidspreker heeft. Belgebeurtenissen van de switch naar de telefoon kunnen worden toegewezen aan een visuele waarschuwing op het scherm van de computer of ze kunnen worden gerouteerd naar een telefoonapparaat. Lampgebeurtenissen en weergavegebeurtenissen kunnen worden genegeerd of gerouteerd naar een telefoonapparaat (die lijkt te gedragen als een normale telefoonset). Ten slotte drukt de knop op een telefoonapparaat mogelijk of niet door aan de lijn. In ieder geval heeft deze routering van signalen van laag niveau van de lijn geen invloed op de werking van het lijngedeelte van TAPI, dat altijd gebeurtenissen op laag niveau toe wijst aan hun functionele equivalent. Raadpleeg de mogelijkheden van het lijnapparaat met lineGetDevCapsom de terminals te bepalen die beschikbaar zijn (en hun mogelijkheden).

Stel dat de toepassing de routering van alle gebeurtenissen (met lineSetTerminal) heeft onderdrukt en dat de gebruiker een headset selecteert als het huidige I/O-apparaat. Een inkomende oproep verzendt een LINE_CALLSTATE bericht en een LINE_LINEDEVSTATE bericht met de indicatie. Omdat routering van alle gebeurtenissen wordt onderdrukt, worden ringgebeurtenissen niet naar de telefoon gerouteerd, zodat bellen wordt onderdrukt. In plaats daarvan meldt de toepassing de gebruiker met een pop-updialoogvenster en een systeemepep in de headset.

De gebruiker besluit de oproep te beantwoorden. Omdat het huidige I/O-apparaat van de gebruiker de headset is, roept de telefonietoepassing lineSetTerminal aan op de binnenkomende oproep om de media van de oproep door te sturen naar de headset en het gesprek te beantwoorden. De toepassing kan ook lineSetTerminal aanroepen om lamp te routeren en informatie-gebeurtenissen weer te geven aan de telefoonset, zodat deze zich normaal gedraagt.

Als tweede voorbeeld wordt ervan uitgegaan dat een inkomende oproep een waarschuwing ontvangt op de computer van de gebruiker. In plaats van de antwoordoptie met de muis te selecteren, besluit de gebruiker gewoon de handset van de telefoon op te halen om het gesprek te beantwoorden. De offhookstatus op de telefoon verzendt een bericht naar de toepassing. De toepassing kan deze status interpreteren als een verzoek van de gebruiker om de telefoonhoorn te selecteren om het gesprek uit te voeren. De toepassing roept vervolgens lineSetTerminal aan om de spraakgegevens van het gesprek naar de telefoonset te routeren.