اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

Sl4aBluetoothUtil

public class Sl4aBluetoothUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.Sl4aBluetoothUtil

فئة الأدوات المساعدة توفّر عمليات البلوتوث على جهاز واحد أو جهازَين باستخدام SL4A

ملخّص

طُرق وضع التصميم العامة
`Sl4aBluetoothUtil()`

الإجراءات العامة
`boolean`	`changeProfileAccessPermission(ITestDevice primary, ITestDevice secondary, Sl4aBluetoothUtil.BluetoothProfile profile, Sl4aBluetoothUtil.BluetoothAccessLevel access)` تغيير إذن الوصول إلى ملف البلوتوث الخاص بالجهاز الثانوي على الجهاز الأساسي لكي يتمكّن الجهاز الثانوي من الوصول إلى الجهاز الأساسي على الملف الشخصي المحدّد
`boolean`	`connect(ITestDevice primary, ITestDevice secondary, Set<Sl4aBluetoothUtil.BluetoothProfile> profiles)` ربط الجهاز الأساسي بالجهاز الثانوي على ملفات تعريف البلوتوث المحدّدة
`boolean`	`disable(ITestDevice device)` إيقاف البلوتوث على جهاز الاختبار
`boolean`	`disableBluetoothSnoopLog(ITestDevice device)` إيقاف سجلّ التطفل على البلوتوث
`boolean`	`disconnect(ITestDevice primary, ITestDevice secondary, Set<Sl4aBluetoothUtil.BluetoothProfile> profiles)` إلغاء ربط الجهاز الأساسي بالجهاز الثانوي
`boolean`	`enable(ITestDevice device)` تفعيل البلوتوث على جهاز الاختبار
`boolean`	`enableBluetoothSnoopLog(ITestDevice device)` تفعيل سجلّ التطفل على البلوتوث
`String`	`getAddress(ITestDevice device)` الحصول على عنوان MAC لجهاز الاختبار المستهدف
`Set<String>`	`getBondedDevices(ITestDevice device)` الحصول على مجموعة من عناوين MAC لأجهزة البلوتوث المرتبطة (المقترنة) بجهاز الاختبار
`boolean`	`pair(ITestDevice primary, ITestDevice secondary)` إقران الجهاز الأساسي بالجهاز الثانوي
`void`	`setBtConnectionTimeout(Duration timeout)`
`void`	`setBtPairTimeout(Duration timeout)`
`boolean`	`setProfilePriority(ITestDevice primary, ITestDevice secondary, Set<Sl4aBluetoothUtil.BluetoothProfile> profiles, Sl4aBluetoothUtil.BluetoothPriorityLevel priority)` تغيير إعدادات الأولوية للملفات الشخصية المحدّدة على الجهاز الأساسي تجاه الجهاز الثانوي
`void`	`startSl4a(ITestDevice device, File sl4aApkFile)` ابدأ عميل SL4A بشكل صريح باستخدام الجهاز وملف حزمة تطبيق SL4A المحدّدَين.
`void`	`stopSl4a()` إيقاف عملاء SL4A الذين تم فتحهم من قبل
`boolean`	`unpairAll(ITestDevice device)` إلغاء إقران جميع الأجهزة المقترنة بالجهاز الحالي

طُرق محمية
`void`	`finalize()` تنظيف جميع اتصالات SL4A

طُرق وضع التصميم العامة

Sl4aBluetoothUtil

public Sl4aBluetoothUtil ()

الإجراءات العامة

changeProfileAccessPermission

public boolean changeProfileAccessPermission (ITestDevice primary, 
                ITestDevice secondary, 
                Sl4aBluetoothUtil.BluetoothProfile profile, 
                Sl4aBluetoothUtil.BluetoothAccessLevel access)

تغيير إذن الوصول إلى ملف البلوتوث الخاص بالجهاز الثانوي على الجهاز الأساسي لكي يتمكّن الجهاز الثانوي من الوصول إلى الجهاز الأساسي على الملف الشخصي المحدّد

المعلَمات
`primary`	‫`ITestDevice`: الجهاز الذي سيتم تغيير الإذن عليه
`secondary`	‫`ITestDevice`: الجهاز الذي يمكنه الوصول إلى الجهاز الأساسي في الملف الشخصي المحدّد
`profile`	`Sl4aBluetoothUtil.BluetoothProfile`: ملف البلوتوث الذي تريد الوصول إليه
`access`	‫`Sl4aBluetoothUtil.BluetoothAccessLevel`: مستوى الوصول، يمكنك الاطّلاع على `BluetoothAccessLevel`

المرتجعات
`boolean`	صحيح إذا تم تغيير الإذن بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ربط

public boolean connect (ITestDevice primary, 
                ITestDevice secondary, 
                Set<Sl4aBluetoothUtil.BluetoothProfile> profiles)

ربط الجهاز الأساسي بالجهاز الثانوي على ملفات تعريف البلوتوث المحدّدة

المعلَمات
`primary`	‫`ITestDevice`: الجهاز الذي سيتم الاتصال منه
`secondary`	‫`ITestDevice`: الجهاز الذي تريد الاتصال به
`profiles`	`Set`: يجب ربط مجموعة من ملفات البلوتوث

المرتجعات
`boolean`	صحيح إذا تم الاتصال بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

إيقاف

public boolean disable (ITestDevice device)

إيقاف البلوتوث على جهاز الاختبار

المعلَمات
`device`	‫`ITestDevice`: جهاز الاختبار

المرتجعات
`boolean`	صحيح إذا تم إيقاف البلوتوث بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableBluetoothSnoopLog

public boolean disableBluetoothSnoopLog (ITestDevice device)

إيقاف سجلّ التطفل على البلوتوث

المعلَمات
`device`	‫`ITestDevice`: لإيقاف سجلّ التجسّس

المرتجعات
`boolean`	صحيح إذا تم إيقافها بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

إلغاء الربط

public boolean disconnect (ITestDevice primary, 
                ITestDevice secondary, 
                Set<Sl4aBluetoothUtil.BluetoothProfile> profiles)

إلغاء ربط الجهاز الأساسي بالجهاز الثانوي

المعلَمات
`primary`	‫`ITestDevice`: الجهاز الذي سيتم إجراء عملية إلغاء الربط عليه
`secondary`	‫`ITestDevice`: الجهاز المطلوب إلغاء ربطه
`profiles`	‫`Set`: مجموعة معيّنة من ملفات تعريف البلوتوث يجب فصلها

المرتجعات
`boolean`	صحيح إذا تم قطع الاتصال بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

تفعيل

public boolean enable (ITestDevice device)

تفعيل البلوتوث على جهاز الاختبار

المعلَمات
`device`	‫`ITestDevice`: جهاز الاختبار

المرتجعات
`boolean`	صحيح إذا تم تفعيل البلوتوث بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableBluetoothSnoopLog

public boolean enableBluetoothSnoopLog (ITestDevice device)

تفعيل سجلّ التطفل على البلوتوث

المعلَمات
`device`	‫`ITestDevice`: لتفعيل سجلّ التطفّل

المرتجعات
`boolean`	صحيح إذا تم التفعيل بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAddress

public String getAddress (ITestDevice device)

الحصول على عنوان MAC لجهاز الاختبار المستهدف

المعلَمات
`device`	‫`ITestDevice`: جهاز الاختبار

المرتجعات
`String`	سلسلة عنوان MAC

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBondedDevices

public Set<String> getBondedDevices (ITestDevice device)

الحصول على مجموعة من عناوين MAC لأجهزة البلوتوث المرتبطة (المقترنة) بجهاز الاختبار

المعلَمات
`device`	‫`ITestDevice`: جهاز الاختبار

المرتجعات
`Set<String>`	مجموعة من عناوين MAC لأجهزة البلوتوث

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ازدواج

public boolean pair (ITestDevice primary, 
                ITestDevice secondary)

إقران الجهاز الأساسي بالجهاز الثانوي

المعلَمات
`primary`	‫`ITestDevice`: الجهاز الذي سيتم الإقران منه
`secondary`	‫`ITestDevice`: الجهاز المطلوب إقرانه

المرتجعات
`boolean`	صحيح إذا تم الإقران بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setBtConnectionTimeout

public void setBtConnectionTimeout (Duration timeout)

المعلَمات
`timeout`	`Duration`

setBtPairTimeout

public void setBtPairTimeout (Duration timeout)

المعلَمات
`timeout`	`Duration`

setProfilePriority

public boolean setProfilePriority (ITestDevice primary, 
                ITestDevice secondary, 
                Set<Sl4aBluetoothUtil.BluetoothProfile> profiles, 
                Sl4aBluetoothUtil.BluetoothPriorityLevel priority)

تغيير إعدادات الأولوية للملفات الشخصية المحدّدة على الجهاز الأساسي تجاه الجهاز الثانوي

المعلَمات
`primary`	‫`ITestDevice`: الجهاز الذي سيتم ضبط الأولوية عليه
`secondary`	‫`ITestDevice`: الجهاز الذي سيتم ضبط الأولوية له
`profiles`	‫`Set`: ملفات البلوتوث لتغيير إعداد الأولوية
`priority`	‫`Sl4aBluetoothUtil.BluetoothPriorityLevel`: مستوى الأولوية

المرتجعات
`boolean`	صحيح إذا تم ضبط الأولوية بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startSl4a

public void startSl4a (ITestDevice device, 
                File sl4aApkFile)

ابدأ عميل SL4A بشكل صريح باستخدام الجهاز وملف حزمة تطبيق SL4A المحدّدَين. عادةً، لا تكون هذه الطريقة مطلوبة، لأنّه سيتم دائمًا إنشاء اتصال SL4A قبل إجراء العمليات الفعلية.

المعلَمات
`device`	‫`ITestDevice`: الجهاز الذي سيتم ربطه باستخدام SL4A
`sl4aApkFile`	`File`: حزمة APK الاختيارية الخاصة بـ SL4A التي سيتم تثبيتها واستخدامها

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopSl4a

public void stopSl4a ()

إيقاف عملاء SL4A الذين تم فتحهم من قبل وهي توفّر بشكل أساسي طريقة لتنظيف العملاء فورًا بعد التوقف عن استخدامهم

unpairAll

public boolean unpairAll (ITestDevice device)

إلغاء إقران جميع الأجهزة المقترنة بالجهاز الحالي

المعلَمات
`device`	‫`ITestDevice`: الجهاز الحالي لتنفيذ الإجراء

المرتجعات
`boolean`	صحيح إذا تم إلغاء الإقران بنجاح

عمليات الطرح
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

طُرق محمية

الإنهاء

protected void finalize ()

تنظيف جميع اتصالات SL4A