| org.bluez.obex.MessageAccess(5) | مدیریت سیستم لینوکس | org.bluez.obex.MessageAccess(5) |
نام (NAME)
org.bluez.obex.MessageAccess - مستندات واسط D-Bus دسترسی به پیامهای OBEX در BlueZ
واسط (INTERFACE)
- Service
- org.bluez.obex
- Interface
- org.bluez.obex.MessageAccess1
- Object path
- [Session object path]
متدها (Methods)
void SetFolder(string name)
دایرکتوری کاری را برای نشست جاری تنظیم میکند.
نامهای ممکن:
خطاهای ممکن:
array{dict} ListFolders(dict filter)
یک دیکشنری حاوی اطلاعات مربوط به محتوای پوشه جاری را برمیگرداند.
فیلترهای ممکن:
- uint16 Offset (پیشفرض 0)
- آفست نخستین مورد.
- uint16 MaxCount (پیشفرض 1024)
- حداکثر تعداد موارد.
مقادیر بازگشتی ممکن:
- string Name
- نام پوشه
خطاهای ممکن:
array{string} ListFilterFields()
تمام فیلدهای موجود را که میتوان در فیلتر Fields استفاده کرد، برمیگرداند.
مقادیر ممکن:
- "subject"
- "timestamp"
- "sender"
- "sender-address"
- "recipient"
- "recipient-address"
- "type"
- "size"
- "status"
- "text"
- "attachment"
- "priority"
- "read"
- "sent"
- "protected"
- "replyto"
خطاهای ممکن: ندارد
array{object, dict} ListMessages(string folder, dict filter)
آرایهای شامل اشیاء پیامهای یافتشده در زیرپوشه دادهشده از پوشه جاری، یا در صورت خالی بودن پوشه، در پوشه جاری را برمیگرداند.
فیلترهای ممکن:
- uint16 Offset (پیشفرض 0)
- آفست نخستین مورد.
uint16 MaxCount (پیشفرض 1024):
- byte SubjectLength (پیشفرض 256)
- حداکثر طول ویژگی Subject در پیام.
- array{string} Fields
- فیلدهای
پیام،
مقدار
پیشفرض
شامل تمام
مقادیر است.
برای مقادیر ممکن به ListFilterFields() مراجعه کنید.
- array{string} Types
- فیلتر کردن
پیامها بر
اساس نوع.
مقادیر ممکن:
- "sms"
- "email"
- "mms"
- string PeriodBegin
- فیلتر کردن
پیامها بر
اساس دوره
زمانی
آغازین.
مقادیر ممکن:
- string PeriodEnd
- فیلتر کردن
پیامها بر
اساس دوره
زمانی
پایانی.
مقادیر ممکن:
- boolean Read
- فیلتر کردن
پیامها بر
اساس پرچم
خواندهشدن.
مقادیر ممکن:
- string Recipient
- فیلتر کردن پیامها بر اساس نشانی گیرنده.
- string Sender
- فیلتر کردن پیامها بر اساس نشانی فرستنده.
- boolean Priority
- فیلتر کردن
پیامها بر
اساس پرچم
اولویت.
مقادیر ممکن:
هر پیام با یک مسیر شیء نشان داده میشود که واسط org.bluez.obex.Message(5) را پیادهسازی میکند، و به دنبال آن دیکشنری ویژگیهای آن قرار دارد.
void UpdateInbox(void)
از دستگاه دوردست درخواست میکند تا صندوق ورودی خود را بهروزرسانی کند.
خطاهای ممکن:
object, dict PushMessage(string sourcefile, string folder, dict args)
پیامی (در قالب bMessage) را به دستگاه دوردست منتقل میکند.
پیام به زیرپوشه مشخصشده از پوشه جاری، یا در صورت خالی بودن پوشه، به پوشه جاری منتقل میشود.
آرگومانهای ممکن: Transparent، Retry، Charset
مسیر بازگرداندهشده نشاندهنده انتقال تازهایجادشده است که باید برای بررسی انتقال موفقیتآمیز محتوا یا شکست عملیات استفاده شود.
ویژگیهای این انتقال نیز به همراه مسیر شیء برگردانده میشوند تا از فراخوانی GetProperties جلوگیری شود؛ برای فهرست ویژگیهای ممکن به org.bluez.obex.Transfer(5) مراجعه کنید.
خطاهای ممکن:
ویژگیها (Properties)
array{string} SupportedTypes [readonly]
فهرست انواع پیامهای پشتیبانیشده.
مقادیر ممکن:
- "EMAIL"
- پیامهای ایمیل.
- "SMS_GSM"
- پیامهای کوتاه GSM.
- "SMS_CDMA"
- پیامهای کوتاه CDMA.
- "MMS"
- پیامهای MMS.
- "IM"
- پیامرسانی فوری.
| اکتبر 2023 | BlueZ |