اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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, profiles)` توصيل الجهاز الأساسي بالجهاز الثانوي في الملفات الشخصية المحدّدة للبلوتوث
`boolean`	`disable(ITestDevice device)` إيقاف البلوتوث على الجهاز المستهدَف
`boolean`	`disableBluetoothSnoopLog(ITestDevice device)` إيقاف سجلّ التطفل على البلوتوث
`boolean`	`disconnect(ITestDevice primary, ITestDevice secondary, profiles)` إلغاء ربط الجهاز الأساسي بالجهاز الثانوي
`boolean`	`enable(ITestDevice device)` تفعيل البلوتوث على الجهاز المستهدَف
`boolean`	`enableBluetoothSnoopLog(ITestDevice device)` تفعيل سجلّ التطفل على البلوتوث
`String`	`getAddress(ITestDevice device)` الحصول على عنوان MAC لتقنية البلوتوث للجهاز المستهدَف
	`getBondedDevices(ITestDevice device)` الحصول على مجموعة من عناوين MAC الخاصة بتقنية البلوتوث للأجهزة المرتبطة (المقرونة) على الجهاز المستهدَف
`boolean`	`pair(ITestDevice primary, ITestDevice secondary)` إقران الجهاز الأساسي بالجهاز الثانوي
`void`	`setBtConnectionTimeout(Duration timeout)`
`void`	`setBtPairTimeout(Duration timeout)`
`boolean`	`setProfilePriority(ITestDevice primary, ITestDevice secondary, profiles, Sl4aBluetoothUtil.BluetoothPriorityLevel priority)` تغيير إعدادات الأولوية للملفات الشخصية المحدّدة على الجهاز الأساسي إلى الجهاز الثانوي
`void`	`startSl4a(ITestDevice device, File sl4aApkFile)` ابدأ عميل SL4A صراحةً باستخدام الجهاز المحدَّد وملف apk الخاص بـ 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, 
                 profiles)

توصيل الجهاز الأساسي بالجهاز الثانوي في الملفات الشخصية المحدّدة للبلوتوث

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

المرتجعات
`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, 
                 profiles)

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

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

المرتجعات
`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  getBondedDevices (ITestDevice device)

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

المعلمات
`device`	`ITestDevice`: الجهاز المستهدَف

المرتجعات
	مجموعة عناوين 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, 
                 profiles, 
                Sl4aBluetoothUtil.BluetoothPriorityLevel priority)

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

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

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

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

startSl4a

public void startSl4a (ITestDevice device, 
                File sl4aApkFile)

ابدأ عميل SL4A صراحةً باستخدام الجهاز المحدَّد وملف apk الخاص بـ 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