Udostępnij przez


Kontrola urządzenia (interfejs API telefonii)

Kontrola urządzenia na poziomie aplikacji użytkownika końcowego lub serwera wymaga stosunkowo małego zestawu podstawowych informacji. Warstwa abstrakcji dostawcy usług wykonuje szczegółową kontrolę urządzenia. Dostawcy usług zgłaszają wymagane informacje o urządzeniu do aplikacji za pośrednictwem interfejsu TAPI.

Kluczowe kategorie urządzeń obejmują:

  • Network: warstwa transportu komunikacji. Z punktu widzenia aplikacji informacje o sieci są zwykle osadzone w typie adresu, takim jak LINEADDRESSTYPE_PHONENUMBER.
  • linia: połączenie z siecią. Ta koncepcja jest mocno używana w interfejsie TAPI 2.2 (TAPI/C).
  • channel: poddział wiersza. Znajomość kanałów zwykle nie jest wymagana dla aplikacji, ponieważ dostawca usług konfiguruje sposób ich wyświetlania jako adresy.
  • adres: lokalizacja sieciowa w sieci. Każdy wiersz lub kanał ma co najmniej jeden skojarzony adres. Adres jest kluczową koncepcją zarówno w interfejsie TAPI 3.1 (TAPI/COM) jak i interfejsie TAPI 2.2 (TAPI/C).
  • terminalu: źródło lub renderer dla określonego adresu i typu nośnika.

Dostawcy usług zgłaszają charakterystykę urządzenia interfejsu TAPI w odpowiedzi na zapytania aplikacji. Dostawcy usług inicjują również raporty dotyczące zmian stanu urządzenia. Te zmiany są następnie zgłaszane do aplikacji na podstawie powiadomień żądanych podczas inicjowania.

Podstawowe cechy urządzeń to:

Ponadto dostawcy usług dostarczają informacje dotyczące pojemności danego adresu w celu wykonywania różnych operacji sesji.

Dodatkowe cechy mogą być skojarzone z niektórymi urządzeniami, jeśli dostawcy usług je obsługują. Aplikacja TAPI 2.x odnajduje możliwości przy użyciu funkcji lineGetDevCaps i lineGetAddressCaps. W tym celu aplikacje TAPI 3.x używają interfejsu ITAddressCapabilities.

Interfejs TAPI 2.x udostępnia specjalny zestaw operacji uzupełniających, które dostawca usług może zaimplementować do użytku z urządzeniami telefonicznymi. Zobacz Phone Devices.

Rozszerzone możliwości są specyficzne dla dostawcy i nie są bezpośrednio objęte interfejsem API telefonii firmy Microsoft. Zobacz funkcje rozszerzonej linii , rozszerzone funkcje telefoniilub interfejsy Provider-Specific.

Poniżej znajduje się podsumowanie operacji interfejsu TAPI, które wysyłają zapytania do dostawców usług w cechach urządzeń i dostarczają dane dotyczące bieżącego stanu.

Funkcje TAPI 2.x Opis
lineGetDevCaps Wysyła zapytanie do określonego urządzenia liniowego w celu określenia możliwości telefonii skojarzonych adresów.
lineGetAddressCaps Wysyła zapytanie do określonego urządzenia liniowego w celu określenia możliwości telefonii określonego adresu.
lineGetDevConfig Zwraca "nieprzezroczystą" strukturę danych, która przechowuje bieżącą konfigurację urządzenia.
lineSetDevConfig Przywraca konfigurację urządzenia.
lineConfigDialog Wyświetl okno dialogowe umożliwiające użytkownikowi konfigurowanie parametrów związanych z urządzeniem.
lineGetID Pobiera stabilny identyfikator urządzenia, który może być używany w kolejnych wywołaniach funkcji TAPI lub z innym interfejsem API.
lineGetLineDevStatus Wysyła zapytanie do urządzenia o bieżący stan, na przykład liczbę aktywnych wywołań.
lineSetLineDevStatus Ustawia stan urządzenia, taki jak ustawienie urządzenia jako nie w usłudze.
lineGetIcon Pobiera ikonę specyficzną dla dostawcy do wyświetlania użytkownikowi.
lineNegotiateExtVersion Umożliwia aplikacji negocjowanie wersji rozszerzenia do użycia z określonym urządzeniem liniowym.
lineDevSpecific Zapewnia dostęp do funkcji specyficznych dla urządzenia.
lineDevSpecificFeature Wysyła funkcje specyficzne dla urządzenia do dostawcy usług.

 

Interfejsy lub metody TAPI 3.x Opis
ITAddressCapabilities Pobiera informacje dotyczące możliwości adresu.
ITAMMediaFormat Ustawia i pobiera format nośnika DirectShow™.
ITBasicAudioTerminal Ustawia standardowe charakterystyki terminalu audio, takie jak głośność.
ITMediaSupport Pobiera informacje dotyczące możliwości obsługi multimediów adresu.
ITTerminal Interfejs podstawowy dla obiektu terminalu. Uzyskuje informacje, takie jak klasa terminalu i obsługiwane nośniki.
ITTerminalSupport Pobiera informacje o dostępnych terminalach i tworzy dodatkowe terminale.
interfejsy Provider-Specific Zależny od dostawcy usług.