.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "org.bluez.Call1" "5" "May 2025" "BlueZ" "Linux System Administration"
.SH "نام (NAME)"
org.bluez.Call \- رابط کاربری D-Bus برای مدیریت تماس‌های بلوتوث در BlueZ
.SH "رابط (INTERFACE)"
.INDENT 0.0
.TP
.B سرویس (Service)
org.bluez
.TP
.B رابط (Interface)
org.bluez.Call1 [experimental]
.TP
.B مسیر شیء (Object path)
[variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/telephony#/call#
.TP
.B مورد استفاده توسط (Used by)
\fBbluetoothctl\-telephony(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS void Answer()
.sp
به یک تماس ورودی پاسخ می‌دهد. تنها در صورتی معتبر است که وضعیت تماس برابر با \(dqincoming\(dq باشد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> telephony.answer <call>
.UNINDENT
.SS void Hangup()
.sp
تماس را قطع می‌کند.
.sp
برای یک تماس ورودی، تماس با استفاده از ATH یا معادل آن قطع می‌شود. برای یک تماس پشت خط (waiting)، با استفاده از وضعیت «مشغول بودن کاربر به تشخیص خودش» (User Determined User Busy یا UDUB) به طرف مقابل اطلاع داده می‌شود. این کار عموماً با استفاده از CHLD=0 پیاده‌سازی می‌شود.
.sp
لطفاً توجه داشته باشید که مشخصات GSM در زمان وجود یک تماس پشت خط، اجازه قطع کردن تماس در حالت انتظار (held) را نمی‌دهد. دلیل این امر آن است که استاندارد 27.007 تنها به CHLD=1X اجازه می‌دهد روی تماس‌های فعال عمل کند. بنابراین یک تماس در حالت انتظار نمی‌تواند بدون تحت تأثیر قرار دادن وضعیت تماس ورودی قطع شود (برای نمونه با استفاده از سایر گزینه‌های CHLD). بیشتر سازندگان افزونه‌های اختصاصی (vendor extensions) ارائه می‌دهند که امکان تغییر وضعیت تماس در حالت انتظار را با استفاده از CHLD=1X یا معادل آن فراهم می‌کند. باید توجه داشت که Bluetooth HFP رفتار کلاسیک 27.007 را مشخص می‌کند و به CHLD=1X اجازه تغییر وضعیت تماس‌های در حالت انتظار را نمی‌دهد.
.sp
بر اساس بحث بالا، همچنین باید توجه داشت که قطع کردن ارتباط یک طرف خاص در یک تماس چندنفرهٔ در حالت انتظار ممکن است در برخی پیاده‌سازی‌ها امکان‌پذیر نباشد. توصیه می‌شود برنامه‌ها رابط کاربری (UI) خود را بر همین اساس طراحی کنند.
.sp
نکته: قطع کردن تماس‌های فعال هیچ‌گونه عوارض جانبی (side\-effects) ایجاد نمی‌کند؛ یعنی وضعیت تماس‌های در حالت انتظار یا پشت خط تحت تأثیر قرار نمی‌گیرد. به عنوان یک استثنا، در حالتی که تنها یک تماس فعال و یک تماس پشت خط وجود داشته باشد، قطع کردن تماس فعال موجب انتقال تماس پشت خط به وضعیت \(aqincoming\(aq خواهد شد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> telephony.hangup <call>
.UNINDENT
.SS "ویژگی‌ها (Properties)"
.SS string LineIdentification [readonly]
.sp
شامل اطلاعات شناسایی خط (Line Identification) بازگردانده‌شده از شبکه است، در صورتی که وجود داشته باشد. برای تماس‌های ورودی این عملاً همان CLIP است. برای تماس‌های خروجی این ویژگی شماره گرفته‌شده، یا COLP را در صورت دریافت توسط درگاه صوتی (audio gateway) نگه‌داری می‌کند.
.sp
لطفاً توجه داشته باشید که COLP ممکن است با شماره گرفته‌شده متفاوت باشد. مقدار ویژه \(dqwithheld\(dq به این معناست که طرف مقابل از ارائه شناسه تماس‌گیرنده (caller ID) خودداری کرده و گزینه \(dqoverride category\(dq برای مشترک جاری فراهم نشده است.
.SS string IncomingLine [readonly, optional]
.sp
شامل اطلاعات شناسایی خط تماس‌گرفته‌شده (Called Line Identification) بازگردانده‌شده از شبکه است. این ویژگی تنها برای تماس‌های ورودی در دسترس است و شماره مشترک محلی را که توسط طرف مقابل شماره‌گیری شده نشان می‌دهد. این مورد برای مشترکانی کاربرد دارد که از سرویس چندخطی ارائه‌دهنده شبکه خود استفاده می‌کنند و مایلند بدانند تماس روی کدام خط در حال دریافت است.
.SS string Name [readonly]
.sp
شامل اطلاعات شناسایی نام (Name Identification) بازگردانده‌شده از شبکه است، در صورتی که وجود داشته باشد.
.SS boolean Multiparty [readonly]
.sp
نشان‌دهنده این است که آیا تماس بخشی از یک تماس چندنفره است یا خیر.
.sp
اعلان‌هایی در صورت ملحق شدن یک تماس به یک تماس چندنفره یا خروج از آن ارسال می‌شود.
.SS string State [readonly]
.sp
شامل وضعیت تماس فعلی است.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqactive\(dq
تماس فعال است
.TP
.B \(dqheld\(dq
تماس در حالت انتظار است
.TP
.B \(dqdialing\(dq
تماس در حال شماره‌گیری است
.TP
.B \(dqalerting\(dq
دستگاه طرف مقابل در حال زنگ خوردن (هشدار) است
.TP
.B \(dqincoming\(dq
تماس ورودی در جریان است
.TP
.B \(dqwaiting\(dq
تماس پشت خط است
.TP
.B \(dqresponse_and_hold\(dq
تماس ورودی در حالت پاسخ و انتظار (response and hold) قرار گرفته است
.TP
.B \(dqdisconnected\(dq
هیچ استفاده دیگری از این شیء مجاز نیست و به‌زودی از بین خواهد رفت
.UNINDENT
.\" End of generated man page.