.\" 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.obex.PhonebookAccess" "5" "اکتبر 2023" "BlueZ" "مدیریت سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.obex.PhonebookAccess \- مستندات واسط کاربری دفترچه تلفن OBEX بلوتوث
.SH "واسط (INTERFACE)"
.INDENT 0.0
.TP
.B Service
org.bluez.obex
.TP
.B Interface
org.bluez.obex.PhonebookAccess1
.TP
.B Object path
[Session object path]
.UNINDENT
.SS "متدها (Methods)"
.SS void Select(string location, string phonebook)
.sp
شیء دفترچه تلفن را برای سایر عملیات انتخاب می‌کند.
.sp
باید پیش از همه عملیات‌های دیگر فراخوانی شود.
.sp
مقادیر ممکن مکان (location):
.INDENT 0.0
.TP
.B \(dqint\(dq, \(dqinternal\(dq (پیش‌فرض)
ذخیره در حافظه داخلی.
.TP
.B \(dqsim{#}\(dq
ذخیره در شماره سیم‌کارت.
.UNINDENT
.sp
مقادیر ممکن دفترچه تلفن (phonebook):
.INDENT 0.0
.TP
.B \(dqpb\(dq
ذخیره به عنوان مخاطب.
.TP
.B \(dqich\(dq
ذخیره به عنوان تماس ورودی.
.TP
.B \(dqoch\(dq
ذخیره به عنوان تماس خروجی.
.TP
.B \(dqmch\(dq
ذخیره به عنوان تماس از دست رفته.
.TP
.B \(dqcch\(dq
ذخیره به عنوان ترکیبی از تماس‌های ورودی، خروجی و از دست رفته.
.UNINDENT
.sp
\(dqspd\(dq:
.INDENT 0.0
.INDENT 3.5
ذخیره به عنوان ورودی شماره‌گیری سریع (فقط برای \(dqinternal\(dq)
.UNINDENT
.UNINDENT
.sp
\(dqfav\(dq:
.INDENT 0.0
.INDENT 3.5
ذخیره به عنوان ورودی برگزیده‌ها (فقط برای \(dqinternal\(dq)
.UNINDENT
.UNINDENT
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.InvalidArguments
.TP
.B org.bluez.obex.Error.Failed
.UNINDENT
.SS object, dict PullAll(string targetfile, dict filters)
.sp
کل شیء دفترچه تلفن را از سرور PSE در قالب متنی ساده با فرمت vcard دریافت کرده و در یک پرونده محلی ذخیره می‌کند.
.sp
اگر یک پرونده مقصد خالی داده شود، نامی به طور خودکار برای پرونده موقت تولید خواهد شد.
.sp
مسیر بازگردانده‌شده نشان‌دهنده انتقال تازه‌ایجادشده است که باید برای بررسی این‌که آیا محتوا با موفقیت منتقل شده یا عملیات با شکست مواجه شده است، استفاده شود.
.sp
ویژگی‌های این انتقال نیز همراه با مسیر شیء بازگردانده می‌شوند تا از فراخوانی GetProperties جلوگیری شود؛ برای فهرست ویژگی‌های ممکن به \fBorg.bluez.obex.Transfer(5)\fP مراجعه کنید.
.sp
فیلترهای ممکن:
.INDENT 0.0
.TP
.B string Format
فرمت vcard موارد.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B \(dqvcard21\(dq (پیش‌فرض)
.TP
.B \(dqvcard30\(dq
.UNINDENT
.TP
.B string Order
ترتیب موارد.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B \(dq\(dq
.TP
.B \(dqindexed\(dq
.TP
.B \(dqalphanumeric\(dq
.TP
.B \(dqphonetic\(dq
.UNINDENT
.TP
.B uint16 Offset (پیش‌فرض 0)
آفست نخستین مورد.
.TP
.B uint16 MaxCount (پیش‌فرض 65535)
حداکثر تعداد موارد.
.TP
.B array{string} Fields (پیش‌فرض تمام فیلدها)
فیلدهای vcard مورد.
.sp
برای مقادیر ممکن به \fBListFilterFields()\fP مراجعه کنید.
.TP
.B array{string} FilterAll
فیلتر کردن موارد بر اساس فیلدها با استفاده از منطق AND؛ نمی‌توان همزمان با \fBFilterAny\fP استفاده کرد.
.sp
برای مقادیر ممکن به \fBListFilterFields()\fP مراجعه کنید.
.TP
.B array{string} FilterAny
فیلتر کردن موارد بر اساس فیلدها با استفاده از منطق OR؛ نمی‌توان همزمان با \fBFilterAll\fP استفاده کرد.
.sp
برای مقادیر ممکن به \fBListFilterFields()\fP مراجعه کنید.
.TP
.B bool ResetNewMissedCalls
بازنشانی موارد جدید تماس‌های از دست رفته؛ فقط باید برای پوشه‌های mch و cch استفاده شود.
.UNINDENT
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.InvalidArguments
.TP
.B org.bluez.obex.Forbidden
.UNINDENT
.SS array{string vcard, string name} List(dict filters)
.sp
آرایه‌ای از داده‌های فهرست vcard را بازمی‌گرداند که هر ورودی شامل جفتی از رشته‌های حاوی هندل vcard و نام مخاطب است.
.sp
برای نمونه:
.INDENT 0.0
.TP
.B \(dq1.vcf\(dq
\(dqJohn\(dq
.UNINDENT
.sp
فیلترهای ممکن:
.INDENT 0.0
.TP
.B string Order
ترتیب مخاطبان.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B \(dq\(dq
.TP
.B \(dqindexed\(dq
.TP
.B \(dqalphanumeric\(dq
.TP
.B \(dqphonetic\(dq
.UNINDENT
.TP
.B uint16 Offset
آفست شروع.
.TP
.B uint16 MaxCount
حداکثر تعداد مخاطبان.
.UNINDENT
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.InvalidArguments
.TP
.B org.bluez.obex.Forbidden
.UNINDENT
.SS object, dict Pull(string vcard, string targetfile, dict filters)
.sp
کارت ویزیت (vcard) را در شیء دفترچه تلفن جاری بازیابی کرده و در یک پرونده محلی ذخیره می‌کند.
.sp
اگر یک پرونده مقصد خالی داده شود، نامی به طور خودکار برای پرونده موقت تولید خواهد شد.
.sp
مسیر بازگردانده‌شده نشان‌دهنده انتقال تازه‌ایجادشده است که باید برای بررسی این‌که آیا محتوا با موفقیت منتقل شده یا عملیات با شکست مواجه شده است، استفاده شود.
.sp
ویژگی‌های این انتقال نیز همراه با مسیر شیء بازگردانده می‌شوند تا از فراخوانی GetProperties جلوگیری شود؛ برای فهرست ویژگی‌های ممکن به \fBorg.bluez.obex.Transfer(5)\fP مراجعه کنید.
.sp
فیلترهای ممکن:
.INDENT 0.0
.TP
.B string Format
فرمت داده‌های مخاطب.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B \(dq\(dq
.TP
.B \(dqvcard21\(dq
.TP
.B \(dqvcard30\(dq
.UNINDENT
.TP
.B array{string} Fields
برای مقادیر ممکن به \fBListFilterFields()\fP مراجعه کنید.
.UNINDENT
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.InvalidArguments
.TP
.B org.bluez.obex.Forbidden
.TP
.B org.bluez.obex.Error.Failed
.UNINDENT
.SS array{string vcard, string name} Search(string field, string value, dict filters)
.sp
ورودی‌های مطابق با شرط داده‌شده را جستجو کرده و آرایه‌ای از داده‌های فهرست vcard را بازمی‌گرداند که هر ورودی شامل جفتی از رشته‌های حاوی هندل vcard و نام مخاطب است.
.sp
مقادیر ممکن فیلد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \(dqname\(dq (پیش‌فرض)
جستجو بر اساس نام.
.TP
.B \(dqnumber\(dq
جستجو بر اساس شماره.
.TP
.B \(dqsound\(dq
جستجو بر اساس صوت/تلفظ.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
value: مقدار رشته‌ای مورد نظر برای جستجو
.sp
فیلترهای ممکن:
.INDENT 0.0
.TP
.B string Order
ترتیب مخاطبان.
.sp
مقادیر ممکن:
.INDENT 7.0
.TP
.B \(dq\(dq
.TP
.B \(dqindexed\(dq
.TP
.B \(dqalphanumeric\(dq
.TP
.B \(dqphonetic\(dq
.UNINDENT
.TP
.B uint16 Offset
آفست شروع.
.TP
.B uint16 MaxCount
حداکثر تعداد مخاطبان.
.UNINDENT
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.InvalidArguments
.TP
.B org.bluez.obex.Forbidden
.TP
.B org.bluez.obex.Error.Failed
.UNINDENT
.SS uint16 GetSize()
.sp
تعداد ورودی‌های شیء دفترچه تلفن انتخاب‌شده را که واقعاً استفاده شده‌اند (یعنی اندیس‌هایی که مربوط به ورودی‌های غیر NULL هستند) بازمی‌گرداند.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.Forbidden
.TP
.B org.bluez.obex.Error.Failed
.UNINDENT
.SS void UpdateVersion()
.sp
برای به‌روزرسانی PrimaryCounter و SecondaryCounter تلاش می‌کند.
.sp
خطاهای ممکن:
.INDENT 0.0
.TP
.B org.bluez.obex.Error.NotSupported
.TP
.B org.bluez.obex.Error.Forbidden
.TP
.B org.bluez.obex.Error.Failed
.UNINDENT
.SS array{string} ListFilterFields()
.sp
تمام فیلدهای موجود را که می‌توان در فیلتر Fields استفاده کرد، بازمی‌گرداند.
.sp
خروجی‌های ممکن:
.INDENT 0.0
.TP
.B \(dqVERSION\(dq
.TP
.B \(dqFN\(dq
.TP
.B \(dqN\(dq
.TP
.B \(dqPHOTO\(dq
.TP
.B \(dqBDAY\(dq
.TP
.B \(dqADR\(dq
.TP
.B \(dqLABEL\(dq
.TP
.B \(dqTEL\(dq
.TP
.B \(dqEMAIL\(dq
.TP
.B \(dqMAILER\(dq
.TP
.B \(dqTZ\(dq
.TP
.B \(dqGEO\(dq
.TP
.B \(dqTITLE\(dq
.TP
.B \(dqROLE\(dq
.TP
.B \(dqLOGO\(dq
.TP
.B \(dqAGENT\(dq
.TP
.B \(dqORG\(dq
.TP
.B \(dqNOTE\(dq
.TP
.B \(dqREV\(dq
.TP
.B \(dqSOUND\(dq
.TP
.B \(dqURL\(dq
.TP
.B \(dqUID\(dq
.TP
.B \(dqKEY\(dq
.TP
.B \(dqNICKNAME\(dq
.TP
.B \(dqCATEGORIES\(dq
.TP
.B \(dqPROID\(dq
.TP
.B \(dqCLASS\(dq
.TP
.B \(dqSORT\-STRING\(dq
.TP
.B \(dqX\-IRMC\-CALL\-DATETIME\(dq
.TP
.B \(dqX\-BT\-SPEEDDIALKEY\(dq
.TP
.B \(dqX\-BT\-UCI\(dq
.TP
.B \(dqX\-BT\-UID\(dq
.TP
.B \(dqBIT\-{#}\(dq
.UNINDENT
.sp
خطاهای ممکن: ندارد (None)
.SS "ویژگی‌ها (Properties)"
.SS string Folder [readonly]
.sp
پوشه جاری.
.SS string DatabaseIdentifier [readonly, optional]
.sp
شناسه پایدار پایگاه‌داده ۱۲۸ بیتی.
.sp
مقادیر ممکن:
.INDENT 0.0
.INDENT 3.5
هگزادسیمال ۳۲ نویسه‌ای مانند A1A2A3A4B1B2C1C2D1D2E1E2E3E4E5E6
.UNINDENT
.UNINDENT
.SS string PrimaryCounter [readonly, optional]
.sp
شمارنده نسخه اصلی ۱۲۸ بیتی.
.sp
مقادیر ممکن:
.INDENT 0.0
.INDENT 3.5
هگزادسیمال ۳۲ نویسه‌ای مانند A1A2A3A4B1B2C1C2D1D2E1E2E3E4E5E6
.UNINDENT
.UNINDENT
.SS string SecondaryCounter [readonly, optional]
.sp
شمارنده نسخه ثانویه ۱۲۸ بیتی.
.sp
مقادیر ممکن:
.INDENT 0.0
.INDENT 3.5
هگزادسیمال ۳۲ نویسه‌ای مانند A1A2A3A4B1B2C1C2D1D2E1E2E3E4E5E6
.UNINDENT
.UNINDENT
.SS bool FixedImageSize [readonly, optional]
.sp
پشتیبانی از اندازه تصویر ثابت را مشخص می‌کند.
.sp
مقادیر ممکن:
.INDENT 0.0
.INDENT 3.5
اگر تصویر JPEG با ابعاد 300x300 پیکسل باشد True، در غیر این صورت False.
.UNINDENT
.UNINDENT
.\" End of generated man page.