| org.bluez.obex.PhonebookAccess(5) | مدیریت سیستم لینوکس | org.bluez.obex.PhonebookAccess(5) |
نام (NAME)
org.bluez.obex.PhonebookAccess - مستندات واسط کاربری دفترچه تلفن OBEX بلوتوث
واسط (INTERFACE)
- Service
- org.bluez.obex
- Interface
- org.bluez.obex.PhonebookAccess1
- Object path
- [Session object path]
متدها (Methods)
void Select(string location, string phonebook)
شیء دفترچه تلفن را برای سایر عملیات انتخاب میکند.
باید پیش از همه عملیاتهای دیگر فراخوانی شود.
مقادیر ممکن مکان (location):
- "int", "internal" (پیشفرض)
- ذخیره در حافظه داخلی.
- "sim{#}"
- ذخیره در شماره سیمکارت.
مقادیر ممکن دفترچه تلفن (phonebook):
- "pb"
- ذخیره به عنوان مخاطب.
- "ich"
- ذخیره به عنوان تماس ورودی.
- "och"
- ذخیره به عنوان تماس خروجی.
- "mch"
- ذخیره به عنوان تماس از دست رفته.
- "cch"
- ذخیره به عنوان ترکیبی از تماسهای ورودی، خروجی و از دست رفته.
"spd":
"fav":
خطاهای ممکن:
object, dict PullAll(string targetfile, dict filters)
کل شیء دفترچه تلفن را از سرور PSE در قالب متنی ساده با فرمت vcard دریافت کرده و در یک پرونده محلی ذخیره میکند.
اگر یک پرونده مقصد خالی داده شود، نامی به طور خودکار برای پرونده موقت تولید خواهد شد.
مسیر بازگرداندهشده نشاندهنده انتقال تازهایجادشده است که باید برای بررسی اینکه آیا محتوا با موفقیت منتقل شده یا عملیات با شکست مواجه شده است، استفاده شود.
ویژگیهای این انتقال نیز همراه با مسیر شیء بازگردانده میشوند تا از فراخوانی GetProperties جلوگیری شود؛ برای فهرست ویژگیهای ممکن به org.bluez.obex.Transfer(5) مراجعه کنید.
فیلترهای ممکن:
- string Format
- فرمت vcard
موارد.
مقادیر ممکن:
- "vcard21" (پیشفرض)
- "vcard30"
- string Order
- ترتیب
موارد.
مقادیر ممکن:
- ""
- "indexed"
- "alphanumeric"
- "phonetic"
- uint16 Offset (پیشفرض 0)
- آفست نخستین مورد.
- uint16 MaxCount (پیشفرض 65535)
- حداکثر تعداد موارد.
- array{string} Fields (پیشفرض تمام فیلدها)
- فیلدهای vcard
مورد.
برای مقادیر ممکن به ListFilterFields() مراجعه کنید.
- array{string} FilterAll
- فیلتر کردن
موارد بر
اساس
فیلدها با
استفاده از
منطق AND؛
نمیتوان
همزمان با
FilterAny استفاده
کرد.
برای مقادیر ممکن به ListFilterFields() مراجعه کنید.
- array{string} FilterAny
- فیلتر کردن
موارد بر
اساس
فیلدها با
استفاده از
منطق OR؛
نمیتوان
همزمان با
FilterAll استفاده
کرد.
برای مقادیر ممکن به ListFilterFields() مراجعه کنید.
- bool ResetNewMissedCalls
- بازنشانی موارد جدید تماسهای از دست رفته؛ فقط باید برای پوشههای mch و cch استفاده شود.
خطاهای ممکن:
array{string vcard, string name} List(dict filters)
آرایهای از دادههای فهرست vcard را بازمیگرداند که هر ورودی شامل جفتی از رشتههای حاوی هندل vcard و نام مخاطب است.
برای نمونه:
- "1.vcf"
- "John"
فیلترهای ممکن:
- string Order
- ترتیب
مخاطبان.
مقادیر ممکن:
- ""
- "indexed"
- "alphanumeric"
- "phonetic"
- uint16 Offset
- آفست شروع.
- uint16 MaxCount
- حداکثر تعداد مخاطبان.
خطاهای ممکن:
object, dict Pull(string vcard, string targetfile, dict filters)
کارت ویزیت (vcard) را در شیء دفترچه تلفن جاری بازیابی کرده و در یک پرونده محلی ذخیره میکند.
اگر یک پرونده مقصد خالی داده شود، نامی به طور خودکار برای پرونده موقت تولید خواهد شد.
مسیر بازگرداندهشده نشاندهنده انتقال تازهایجادشده است که باید برای بررسی اینکه آیا محتوا با موفقیت منتقل شده یا عملیات با شکست مواجه شده است، استفاده شود.
ویژگیهای این انتقال نیز همراه با مسیر شیء بازگردانده میشوند تا از فراخوانی GetProperties جلوگیری شود؛ برای فهرست ویژگیهای ممکن به org.bluez.obex.Transfer(5) مراجعه کنید.
فیلترهای ممکن:
- string Format
- فرمت
دادههای
مخاطب.
مقادیر ممکن:
- ""
- "vcard21"
- "vcard30"
- array{string} Fields
- برای مقادیر ممکن به ListFilterFields() مراجعه کنید.
خطاهای ممکن:
array{string vcard, string name} Search(string field, string value, dict filters)
ورودیهای مطابق با شرط دادهشده را جستجو کرده و آرایهای از دادههای فهرست vcard را بازمیگرداند که هر ورودی شامل جفتی از رشتههای حاوی هندل vcard و نام مخاطب است.
مقادیر ممکن فیلد:
- "name" (پیشفرض)
- جستجو بر اساس نام.
- "number"
- جستجو بر اساس شماره.
- "sound"
- جستجو بر اساس صوت/تلفظ.
value: مقدار رشتهای مورد نظر برای جستجو
فیلترهای ممکن:
- string Order
- ترتیب
مخاطبان.
مقادیر ممکن:
- ""
- "indexed"
- "alphanumeric"
- "phonetic"
- uint16 Offset
- آفست شروع.
- uint16 MaxCount
- حداکثر تعداد مخاطبان.
خطاهای ممکن:
uint16 GetSize()
تعداد ورودیهای شیء دفترچه تلفن انتخابشده را که واقعاً استفاده شدهاند (یعنی اندیسهایی که مربوط به ورودیهای غیر NULL هستند) بازمیگرداند.
خطاهای ممکن:
void UpdateVersion()
برای بهروزرسانی PrimaryCounter و SecondaryCounter تلاش میکند.
خطاهای ممکن:
array{string} ListFilterFields()
تمام فیلدهای موجود را که میتوان در فیلتر Fields استفاده کرد، بازمیگرداند.
خروجیهای ممکن:
- "VERSION"
- "FN"
- "N"
- "PHOTO"
- "BDAY"
- "ADR"
- "LABEL"
- "TEL"
- "EMAIL"
- "MAILER"
- "TZ"
- "GEO"
- "TITLE"
- "ROLE"
- "LOGO"
- "AGENT"
- "ORG"
- "NOTE"
- "REV"
- "SOUND"
- "URL"
- "UID"
- "KEY"
- "NICKNAME"
- "CATEGORIES"
- "PROID"
- "CLASS"
- "SORT-STRING"
- "X-IRMC-CALL-DATETIME"
- "X-BT-SPEEDDIALKEY"
- "X-BT-UCI"
- "X-BT-UID"
- "BIT-{#}"
خطاهای ممکن: ندارد (None)
ویژگیها (Properties)
string Folder [readonly]
پوشه جاری.
string DatabaseIdentifier [readonly, optional]
شناسه پایدار پایگاهداده ۱۲۸ بیتی.
مقادیر ممکن:
string PrimaryCounter [readonly, optional]
شمارنده نسخه اصلی ۱۲۸ بیتی.
مقادیر ممکن:
string SecondaryCounter [readonly, optional]
شمارنده نسخه ثانویه ۱۲۸ بیتی.
مقادیر ممکن:
bool FixedImageSize [readonly, optional]
پشتیبانی از اندازه تصویر ثابت را مشخص میکند.
مقادیر ممکن:
| اکتبر 2023 | BlueZ |