.\" 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.Telephony1" "5" "May 2025" "BlueZ" "Linux System Administration"
.SH "نام (NAME)"
org.bluez.Telephony \- رابط کاربری D-Bus برای تلفن در BlueZ
.SH "رابط (INTERFACE)"
.INDENT 0.0
.TP
.B سرویس (Service)
org.bluez
.TP
.B رابط (Interface)
org.bluez.Telephony1 [experimental]
.TP
.B مسیر شیء (Object path)
[variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/telephony#
.TP
.B مورد استفاده توسط (Used by)
\fBbluetoothctl\-telephony(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS object Dial(string uri)
.sp
شناسه uri از طرحوارهٔ URI (یا URI scheme) و به دنبال آن شناسهٔ تماس‌گیرنده یا شماره مقصد (Caller ID، که می‌تواند یک شماره تلفن یا نام کاربری باشد) تشکیل شده است که با دو‌نقطه از هم جدا می‌شوند.
.sp
نمونه‌هایی از طرحواره‌های رایج URI را می‌توان در طرحواره‌های URI مرجع شماره‌های اختصاص‌یافته اینترنتی (IANA) یافت:
\%<https://\:iana\:.org/\:assignments/\:uri-schemes/\:uri-schemes\:.xhtml>
.sp
این متد یک تماس خروجی جدید برقرار می‌کند و مسیر شیء تماس ایجادشده جدید را برمی‌گرداند.
.sp
برای HFP طرحوارهٔ URI برابر است با \(dqtel:\(dq به همراه شماره تلفن در ادامه آن.
.sp
شماره تلفن باید یک رشته شامل نویسه‌های زیر باشد:
\fI[0\-9+*#,ABCD]{1,80}\fP مجموعه نویسه‌ها می‌تواند شامل ارقام، \fI+\fP، \fI*\fP، \fI#\fP،
\fI,\fP و حروف \fIA\fP تا \fID\fP باشد. به جز این بررسی اولیه صحت، اعتبارسنجی بیشتری روی شماره انجام نمی‌شود. فرض بر این است که درگاه (gateway) و/یا شبکه اعتبارسنجی تکمیلی را انجام خواهند داد.
.sp
اگر شماره تلفن یک رشته خالی باشد، تلاش می‌کند با آخرین شماره گرفته‌شده تماس برقرار کند.
.sp
نکته: در صورت وجود یک تماس فعال (تک‌نفره یا چندنفره)، در صورتی که فرآیند شماره‌گیری موفقیت‌آمیز باشد، آن تماس به‌طور خودکار در حالت انتظار (hold) قرار می‌گیرد.
.sp
خطاهای احتمالی:
.INDENT 0.0
.TP
.B org.bluez.Error.InvalidState
.TP
.B org.bluez.Error.InvalidArguments
.TP
.B org.bluez.Error.NotSupported
.TP
.B org.bluez.Error.Failed
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> telephony.dial <number> [telephony]
.UNINDENT
.SS void SwapCalls()
.sp
تماس‌های فعال (Active) و در انتظار (Held) را با یکدیگر جابه‌جا می‌کند. اثر این کار آن است که تمام تماس‌هایی (۰ یا بیشتر، از جمله تماس‌های یک مکالمه چندنفره) که فعال بودند در حالت انتظار قرار می‌گیرند، و تمام تماس‌هایی (۰ یا بیشتر) که در حالت انتظار بودند، فعال می‌شوند.
.sp
مشخصات GSM اجازه جابه‌جایی تماس‌ها را در حالتی که تماس‌های در حال انتظار، فعال و پشت خط (Waiting) هم‌زمان وجود داشته باشند نمی‌دهد. با این حال برخی مودم‌ها این قابلیت را پیاده‌سازی کرده‌اند، بنابراین موفقیت این متد در صورت وجود تماس‌های Held ،Active و Waiting به سازنده دستگاه بستگی دارد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS void ReleaseAndAnswer()
.sp
تماس‌های فعال فعلی (۰ یا بیشتر) را قطع می‌کند و به تماس پشت خط فعلی پاسخ می‌دهد. لطفاً توجه داشته باشید که اگر تماس فعلی یک تماس چندنفره باشد، تمام طرف‌های حاضر در آن تماس چندنفره قطع خواهند شد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS void ReleaseAndSwap()
.sp
تماس‌های فعال فعلی (۰ یا بیشتر) را قطع کرده و هرگونه تماس در حالت انتظار فعلی را فعال می‌کند. لطفاً توجه داشته باشید که اگر تماس فعلی یک تماس چندنفره باشد، تمام طرف‌های حاضر در آن تماس چندنفره قطع خواهند شد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS void HoldAndAnswer()
.sp
تماس فعلی (شامل تماس‌های چندنفره) را در حالت انتظار قرار می‌دهد و به تماس پشت خط فعلی پاسخ می‌دهد. فراخوانی این متد زمانی که کاربر هم‌زمان دارای هر دو نوع تماس فعال و در حالت انتظار باشد نامعتبر است، زیرا در مشخصات GSM کاربر در یک زمان تنها می‌تواند یک تماس در حالت انتظار داشته باشد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS void HangupAll()
.sp
تمام تماس‌ها را به جز تماس‌های پشت خط (waiting) قطع می‌کند. این شامل تماس‌های چندنفره نیز می‌شود.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.sp
مثال‌ها:
.INDENT 0.0
.TP
.B bluetoothctl
> telephony.hangup\-all [telephony]
.UNINDENT
.SS void HangupActive()
.sp
تماس‌های فعال را قطع می‌کند. این شامل تماس‌های فعال چندنفره نیز می‌شود.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS void HangupHeld()
.sp
تماس‌های در حالت انتظار (held) را به جز تماس‌های پشت خط (waiting) قطع می‌کند. این شامل تماس‌های در حال انتظار چندنفره نیز می‌شود.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS array{object} CreateMultiparty()
.sp
تماس‌های فعال و در حالت انتظار را در قالب یک تماس چندنفره به یکدیگر متصل می‌کند. اگر یکی از تماس‌ها از قبل یک تماس چندنفره باشد، تماس دیگر به مکالمه چندنفره اضافه می‌شود. فهرست جدید تماس‌های حاضر در مکالمه چندنفره را برمی‌گرداند.
.sp
بر اساس مشخصات GSM، تنها یک تماس چندنفرهٔ تحت کنترل مشترک می‌تواند وجود داشته باشد.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.Failed
.SS void SendTones(string tones)
.sp
تن‌های DTMF را به شبکه ارسال می‌کند. این تن‌ها دارای مدت‌زمان ثابتی هستند.
تن‌ها می‌توانند یکی از این موارد باشند: \(aq0\(aq \- \(aq9\(aq، \(aq*\(aq، \(aq#\(aq، \(aqA\(aq، \(aqB\(aq، \(aqC\(aq، \(aqD\(aq. چهار مورد آخر معمولاً در شرایط عادی استفاده نمی‌شوند.
.sp
خطاهای احتمالی:
:org.bluez.Error.InvalidState
:org.bluez.Error.InvalidArgs
:org.bluez.Error.Failed
.SS "ویژگی‌ها (Properties)"
.SS string UUID [readonly]
.sp
شناسه یکتای سراسری (UUID) مربوط به پروفایلی که این درگاه صوتی تلفن برای آن است.
.SS array{string} SupportedURISchemes [readonly]
.sp
شامل فهرست طرحواره‌های URI پشتیبانی‌شده است.
.SS string State [readonly]
.sp
شامل وضعیت اتصال فعلی است.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B \(dqconnecting\(dq
اتصال RFComm در حال انجام است
.TP
.B \(dqslc_connecting\(dq
اتصال در سطح سرویس (Service Level Connection) در حال انجام است
.TP
.B \(dqconnected\(dq
اتصال RFComm و اتصال در سطح سرویس متصل هستند
.TP
.B \(dqdisconnecting\(dq
هیچ استفاده دیگری از این شیء مجاز نیست و به‌زودی از بین خواهد رفت
.UNINDENT
.SS boolean Service [readonly]
.sp
در دسترس بودن سرویس شبکه.
.SS byte Signal [readonly]
.sp
سطح سیگنال شبکه از 0 تا 5.
.SS boolean Roaming [readonly]
.sp
وضعیت استفاده از رومینگ شبکه.
.SS byte BattChg [readonly]
.sp
سطح باتری از 0 تا 5.
.SS string OperatorName [readonly, optional]
.sp
نام اپراتور.
.SS boolean InbandRingtone [readonly]
.sp
در دسترس بودن زنگ درون‌باندی (In\-band Ringtone).
.\" End of generated man page.