متدها (Methods)

void Play()

از سرگیری پخش.

خطاهای احتمالی:

مثال‌ها:

void Pause()

توقف موقت پخش.

خطاهای احتمالی:

مثال‌ها:

void Stop()

توقف پخش.

خطاهای احتمالی:

مثال‌ها:

void Next()

مورد بعدی.

خطاهای احتمالی:

مثال‌ها:

void Previous()

مورد قبلی.

خطاهای احتمالی:

مثال‌ها:

void FastForward()

جلو بردن سریع پخش؛ این عمل تنها زمانی متوقف می‌شود که متد دیگری در این واسط فراخوانی شود.

خطاهای احتمالی:

مثال‌ها:

void Rewind()

عقب بردن سریع پخش؛ این عمل تنها زمانی متوقف می‌شود که متد دیگری در این واسط فراخوانی شود.

خطاهای احتمالی:

مثال‌ها:

void Press(byte avc_key)

فشردن یک کلید مشخص جهت ارسال به عنوان دستور عبوری (passthrough).

کلید به صورت خودکار رها خواهد شد. در صورتی که قصد پایین نگه داشتن کلید را دارید، به جای آن از Hold() استفاده کنید.

خطاهای احتمالی:

void Hold(byte avc_key)

فشردن و نگه داشتن یک کلید مشخص جهت ارسال به عنوان دستور عبوری (passthrough). مسئولیت اطمینان از فراخوانی Release() پس از فراخوانی این متد بر عهده فراخواننده است.

کلید نگه‌داشته‌شده همچنین با فراخوانی هر متد دیگری در این واسط رها خواهد شد.

خطاهای احتمالی:

void Release()

رها کردن کلید نگه‌داشته‌شده قبلی که با استفاده از Hold() فراخوانی شده است.

خطاهای احتمالی:

ویژگی‌ها (Properties)

string Equalizer [readwrite]

تنظیمات اکولایزر پخش‌کننده را مشخص می‌کند.

مقادیر ممکن:

مثال‌ها:

string Repeat [readwrite]

تنظیمات تکرار پخش‌کننده را مشخص می‌کند.

مقادیر ممکن:

مثال‌ها:

string Shuffle [readwrite]

تنظیمات پخش تصادفی پخش‌کننده را مشخص می‌کند.

مقادیر ممکن:

مثال‌ها:

string Scan [readwrite]

تنظیمات پویش (Scan) پخش‌کننده را مشخص می‌کند.

مقادیر ممکن:

مثال‌ها:

string Status [readonly]

وضعیت پخش‌کننده را مشخص می‌کند.

وضعیت‌های ممکن:

uint32 Position [readonly]

موقعیت پخش بر حسب میلی‌ثانیه.

تغییر دادن موقعیت ممکن است رویدادهای بیشتری تولید کند که به دستگاه از راه دور ارسال خواهند شد. هنگامی که موقعیت برابر 0 باشد به این معنی است که قطعه در حال شروع است، و زمانی که بزرگ‌تر یا مساوی با مدت‌زمان قطعه باشد، قطعه پایان یافته است.

توجه داشته باشید که حتی اگر مدت‌زمان در متادیتا موجود نباشد، با تنظیم موقعیت روی حداکثر مقدار uint32 امکان اعلام پایان آن وجود دارد.

dict Track [readonly]

متادیتای قطعه.

مقادیر ممکن:

object Device [readonly]

مسیر شیء دستگاه.

string Name [readonly]

نام پخش‌کننده.

string Type [readonly]

نوع پخش‌کننده.

مقادیر ممکن:

string Subtype [readonly]

زیرنوع پخش‌کننده.

مقادیر ممکن:

boolean Browsable [readonly]

در صورت وجود، نشان می‌دهد که می‌توان پخش‌کننده را با استفاده از واسط MediaFolder مرور کرد.

مقادیر ممکن:

نکته: در صورت پشتیبانی اما غیرفعال بودن، کلاینت‌ها می‌توانند با استفاده از واسط org.bluez.MediaFolder(5) آن را فعال کنند، اما ممکن است در پخش سایر پخش‌کننده‌ها تداخل ایجاد کند.

boolean Searchable [readonly]

در صورت وجود، نشان می‌دهد که می‌توان در پخش‌کننده با استفاده از واسط MediaFolder جستجو کرد.

مقادیر ممکن:

نکته: در صورت پشتیبانی اما غیرفعال بودن، کلاینت‌ها می‌توانند با استفاده از واسط org.bluez.MediaFolder(5) آن را فعال کنند، اما ممکن است در پخش سایر پخش‌کننده‌ها تداخل ایجاد کند.

object Playlist

مسیر شیء فهرست پخش (Playlist).

uint16 ObexPort [readonly, experimental]

در صورت وجود، نشان می‌دهد که پخش‌کننده می‌تواند با استفاده از BIP روی OBEX از طریق این پورت PSM تصویر جلد (cover art) را دریافت کند.