Transférer

L’opération de transfert permet à une application d’envoyer une session de communications actuellement connectée à une autre adresse.

TAPI fournit deux mécanismes pour transférer une session active à une adresse différente. Le transfert aveugle permet de transférer une session existante vers une adresse de destination spécifiée en une seule phase. Le transfert de consultation nécessite l’existence d’une séance de consultation en plus de la session en cours pour la mise en place du transfert, puis l’achèvement du transfert. Le choix entre ces deux types est souvent basé sur les fonctionnalités du fournisseur de services, car certains fournisseurs de services ne prennent pas en charge le transfert aveugle. Dans certains cas, les besoins de l’application peuvent faire du transfert consultatif la méthode préférée, même lorsque le transfert aveugle est possible.

L’opération de transfert aveugle est essentiellement la même sous TAPI 2 et TAPI 3, mais le transfert consultatif suit des modèles légèrement différents.

TAPI 2.x : Le transfert consultatif commence par l’appel de lineSetupTransfer, qui place l’appel existant en attente de consultation et identifie cet appel comme cible pour la demande de transfert-achèvement suivante. La fonction lineSetupTransfer alloue également un appel de consultation qui peut être utilisé pour établir l’appel de consultation avec la partie à laquelle l’appel sera transféré. L’application peut composer l’extension de la partie de destination sur l’appel de consultation (à l’aide de lineDial), ou elle peut supprimer et libérer l’appel de consultation et activer à la place un appel détenu existant (à l’aide de lineUnhold), si le commutateur est pris en charge. Bien que l’appel initial soit en attente de consultation et que l’appel de consultation soit actif, l’application peut basculer entre ces appels à l’aide de lineSwapHold.

TAPI 2.x : Les applications effectuent le transfert consultatif à l’aide de lineCompleteTransfer. Les deux appels rétabliront l’état inactif .

Les applications peuvent utiliser la fonctionnalité de « transfert en une étape » de nombreux PBX (une seule pression sur un bouton pour établir un transfert de consultation) en définissant le paramètre lpCallParams sur le membre LINECALLPARAMFLAGS_ONESTEPTRANSFER des constantes LINECALLPARAMFLAGS_ lors de l’appel de lineSetupTransfer.

TAPI 3.x : Le transfert consultatif commence par l’utilisation de ITAddress::CreateCall pour créer un appel de consultation à la nouvelle adresse de destination. ITBasicCallControl::Transfer est ensuite appelé sur l’objet d’appel d’origine à l’aide d’un pointeur vers le nouvel objet d’appel de consultation en tant que paramètre. L’appel de ITBasicCallControl::Finish sur l’objet d’appel de consultation termine ensuite le transfert.

L’application doit libérer les ressources de session après la réussite d’une opération de transfert.

Tous les fournisseurs de services ne prennent pas en charge l’utilisation de cette opération.

TAPI 2.x : Consultez lineBlindTransfer, lineSetupTransfer, lineCompleteTransfer.

TAPI 3.x : Consultez ITBasicCallControl::BlindTransfer, ITAddress::CreateCall, ITBasicCallControl::Transfer, ITBasicCallControl::Finish.