Konstanta LINECONNECTEDMODE_
Konstanta bendera bit LINECONNECTEDMODE_ menjelaskan substatus panggilan yang terhubung yang berbeda. Mode tersedia sebagai status panggilan ke aplikasi setelah status panggilan beralih ke tersambung, dan dalam pesan LINE_CALLSTATE yang menunjukkan panggilan dalam LINECALLSTATE_CONNECTED. Nilai-nilai ini digunakan ketika panggilan berada di alamat yang dibagikan (dihubungkan) dengan stasiun lain (untuk informasi selengkapnya, lihat LINEADDRESSSHARING_ Constants), terutama sistem kunci elektronik. LINECONNECTEDMODE_constants memiliki nilai berikut:
-
LINECONNECTEDMODE_ACTIVE
-
-
Menunjukkan bahwa panggilan tersambung di stasiun saat ini (stasiun saat ini adalah peserta dalam panggilan). Jika mode status panggilan adalah 0 (nol), aplikasi harus berasumsi bahwa nilainya "aktif" (yang akan menjadi situasi pada alamat non-jembatan). Mode dapat beralih antara ACTIVE dan INACTIVE selama panggilan jika pengguna bergabung dan meninggalkan panggilan melalui tindakan manual. Dalam situasi jembatan seperti itu, operasi lineDrop atau lineHold mungkin mungkin tidak benar-benar menjatuhkan panggilan atau menahannya, karena status stasiun lain pada panggilan dapat mengatur (misalnya, mencoba "menahan" panggilan ketika stasiun lain berpartisipasi tidak dimungkinkan); sebaliknya, panggilan dapat diubah ke mode INACTIVE jika tetap TERHUBUNG di stasiun lain.
-
-
LINECONNECTEDMODE_ACTIVEHELD
-
-
Menunjukkan bahwa stasiun adalah peserta aktif dalam panggilan, tetapi bahwa pihak jarak jauh telah melakukan panggilan ditangguhkan (pihak lain menganggap panggilan berada dalam status di tempat). Biasanya, informasi tersebut hanya tersedia ketika kedua titik akhir panggilan berada dalam domain peralihan yang sama. Bendera ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.0 atau lebih tinggi. (TAPI versi 2.0 dan yang lebih baru)
-
-
LINECONNECTEDMODE_CONFIRMED
-
-
Menunjukkan bahwa penyedia layanan menerima pemberitahuan afirmatif bahwa panggilan telah memasuki status terhubung (misalnya, melalui pengawasan jawaban atau mekanisme serupa). Bendera ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.0 atau lebih tinggi. (TAPI versi 2.0 dan yang lebih baru)
-
-
LINECONNECTEDMODE_INACTIVE
-
-
Menunjukkan bahwa panggilan aktif di satu atau beberapa stasiun lain, tetapi stasiun saat ini bukan peserta dalam panggilan. Jika mode status panggilan adalah ZERO, aplikasi harus mengasumsikan bahwa nilainya "aktif" (yang akan menjadi situasi pada alamat non-jembatan). Panggilan dalam status INACTIVE dapat digabungkan menggunakan lineAnswer. Banyak operasi yang valid dalam panggilan dalam status TERHUBUNG tidak mungkin dalam mode INACTIVE, seperti memantau nada dan digit, karena stasiun sebenarnya tidak berpartisipasi dalam panggilan; pemantauan biasanya ditangguhkan (meskipun tidak dibatalkan) saat panggilan dalam mode TIDAK AKTIF.
-
-
LINECONNECTEDMODE_INACTIVEHELD
-
-
Menunjukkan bahwa stasiun bukan peserta aktif dalam panggilan, dan bahwa pihak jarak jauh telah melakukan panggilan ditangguhkan. Bendera ini hanya diekspos ke aplikasi yang menegosiasikan versi TAPI 2.0 atau lebih tinggi. (TAPI versi 2.0 dan yang lebih baru)
-
Keterangan
Tidak dapat diperluas. Semua 32 bit dicadangkan.
Untuk kompatibilitas mundur, penyedia layanan bertanggung jawab untuk memeriksa versi API yang dinegosiasikan di baris, dan untuk tidak menggunakan nilai-nilai LINECONNECTEDMODE_ yang tidak didukung pada versi yang dinegosiasikan. Aplikasi yang tidak mengenal LINECONNECTEDMODE_ kemungkinan besar akan mengasumsikan bahwa panggilan yang ada di LINECALLSTATE_CONNECTED berada dalam LINECONNECTEDMODE_ACTIVE.
Nilai LINECONNECTEDMODE_ACTIVE dan LINECONNECTEDMODE_INACTIVE digunakan ketika panggilan berada di alamat yang dibagikan dengan stasiun lain (dihubungkan; lihat LINEADDRESSSHARING_ Constants), terutama sistem kunci elektronik. Jika mode status panggilan tersambung "aktif", artinya panggilan tersambung di stasiun saat ini (stasiun saat ini adalah peserta dalam panggilan). Jika mode status panggilan "tidak aktif", panggilan aktif di satu atau beberapa stasiun lain, tetapi stasiun saat ini bukan peserta dalam panggilan. Jika mode status panggilan adalah ZERO, aplikasi harus mengasumsikan bahwa nilainya "aktif" (yang akan menjadi situasi pada alamat non-jembatan). Mode dapat beralih antara ACTIVE dan INACTIVE selama panggilan jika pengguna bergabung dan meninggalkan panggilan melalui tindakan manual.
Dalam situasi jembatan seperti itu, operasi lineDrop atau lineHold mungkin mungkin tidak benar-benar menjatuhkan panggilan atau menahannya, karena status stasiun lain pada panggilan dapat mengatur (misalnya, mencoba "menahan" panggilan ketika stasiun lain berpartisipasi tidak akan mungkin); sebaliknya, panggilan hanya dapat diubah ke mode INACTIVE jika tetap terhubung di stasiun lain. Panggilan dalam status INACTIVE dapat digabungkan menggunakan lineAnswer.
Banyak operasi yang valid dalam panggilan dalam status terhubung tidak mungkin dalam mode INACTIVE, seperti memantau nada dan digit, karena stasiun sebenarnya tidak berpartisipasi dalam panggilan; pemantauan biasanya ditangguhkan (meskipun tidak dibatalkan) saat panggilan dalam mode TIDAK AKTIF.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Versi TAPI |
Membutuhkan TAPI 2.0 atau yang lebih baru |
| Header |
|