fungsi lineAddToConference (tapi.h)

Artikel
08/26/2023

Fungsi lineAddToConference menambahkan panggilan yang ditentukan oleh hConsultCall ke panggilan konferensi yang ditentukan oleh hConfCall.

Sintaks

LONG lineAddToConference(
  HCALL hConfCall,
  HCALL hConsultCall
);

Parameter

hConfCall

Menangani panggilan konferensi. Aplikasi harus menjadi pemilik panggilan ini. Setiap pemantauan (media, nada, digit) pada panggilan konferensi hanya berlaku untuk hConfCall, bukan untuk panggilan yang berpartisipasi individu. Status panggilan hConfCall harus onHoldPendingConference atau onHold.

hConsultCall

Tangani ke panggilan untuk ditambahkan ke panggilan konferensi. Aplikasi harus menjadi pemilik panggilan ini. Panggilan ini tidak boleh menjadi induk konferensi lain atau peserta dalam konferensi apa pun. Bergantung pada kemampuan perangkat yang ditunjukkan dalam LINEADDRESSCAPS, hConsultCall mungkin belum tentu dibuat menggunakan lineSetupConference atau linePrepareAddToConference. Status panggilan hConsultCall harus terhubung, onHold, proceeding, atau ringback. Banyak PBX memungkinkan panggilan ditambahkan ke konferensi sebelum benar-benar dijawab.

Mengembalikan nilai

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron, atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil, atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_CONFERENCEFULL, LINEERR_NOTOWNER, LINEERR_INVALCONFCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Jika LINEERR_INVALCALLHANDLE dikembalikan, handel panggilan yang ditentukan untuk panggilan yang ditambahkan tidak valid; hConsultCall adalah induk dari konferensi lain atau sudah menjadi peserta dalam konferensi; hConsultCall tidak dapat ditambahkan karena alasan lain (seperti, harus dibuat menggunakan lineSetupConference atau linePrepareAddToConference); atau hConsultCall dan hConfCall adalah panggilan pada baris terbuka yang berbeda.

Handel panggilan dari pihak yang ditambahkan tetap valid setelah menambahkan panggilan ke konferensi. Statusnya biasanya berubah menjadi konferensi sementara status panggilan konferensi biasanya menjadi tersambung. Dengan menggunakan lineGetConfRelatedCalls, Anda bisa mendapatkan daftar handel panggilan yang merupakan bagian dari panggilan konferensi yang sama dengan panggilan yang ditentukan. Panggilan yang ditentukan adalah panggilan konferensi atau panggilan peserta dalam panggilan konferensi. Handel baru dihasilkan untuk panggilan yang belum ditangani aplikasi, dan aplikasi diberikan hak istimewa monitor untuk panggilan tersebut. Handel ke panggilan yang berpartisipasi individu dapat digunakan nanti untuk menghapus pihak tersebut dari panggilan konferensi menggunakan lineRemoveFromConference.

Jika lineGetConfRelatedCalls dipanggil segera setelah lineAddToConference, mungkin tidak mengembalikan daftar lengkap panggilan terkait karena TAPI menunggu untuk menerima pesan LINE_CALLSTATE yang menunjukkan bahwa panggilan telah masuk LINECALLSTATE_CONFERENCED sebelum menganggap panggilan benar-benar menjadi bagian dari konferensi (yaitu, status konferensi dikonfirmasi oleh penyedia layanan). Setelah aplikasi menerima pesan LINE_CALLSTATE, lineGetConfRelatedCalls mengembalikan informasi lengkap.

Catatan Semua panggilan yang merupakan bagian dari konferensi harus ada pada baris terbuka yang sama.

Status panggilan panggilan yang berpartisipasi dalam konferensi tidak independen. Misalnya, saat menghilangkan panggilan konferensi, semua panggilan yang berpartisipasi dapat secara otomatis menganggur. Aplikasi harus berkonsultasi dengan kemampuan perangkat baris untuk menentukan bentuk penghapusan konferensi apa yang tersedia. Aplikasi harus melacak pesan LINE_CALLSTATE untuk menentukan apa yang terjadi pada panggilan yang terlibat.

Panggilan konferensi dibuat baik oleh lineSetupConference atau lineCompleteTransfer. Panggilan yang ditambahkan ke konferensi biasanya dibuat menggunakan lineSetupConference atau linePrepareAddToConference. Beberapa sakelar dapat memungkinkan penambahan panggilan arbitrer ke konferensi, dan panggilan seperti itu dapat disiapkan menggunakan lineMakeCall dan berada di penangguhan (keras). Aplikasi ini dapat memeriksa anggota dwAddrCapFlags dari struktur LINEADDRESSCAPS untuk menentukan operasi yang diizinkan.