藍牙工具

public class BluetoothUtils
extends Object

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

用於在裝置上呼叫 BluetoothInstrumentation 的公用程式函式

您可以在 Android 開放原始碼計畫中找到裝置端 BluetoothInstrumentation 程式碼： frameworks/base/core/tests/bluetoothtests

摘要

欄位

public static final String BTSNOOP_API

public static final String BTSNOOP_CMD

public static final String BTSNOOP_DISABLE_CMD

public static final String BTSNOOP_ENABLE_CMD

public static final String GOLD_BTSNOOP_LOG_PATH

public static final String O_BUILD

公用建構函式

BluetoothUtils()

公用方法

static void cleanLogFile(ITestDevice device)

從裝置刪除窺探記錄檔

static boolean disable(ITestDevice device)

停用指定裝置的藍牙功能

static boolean disableBtsnoopLogging(ITestDevice device, File sl4aApkFile)

停用 sl4a 呼叫記錄 btsnoop 記錄

static boolean disableBtsnoopLogging(ITestDevice device)

停用 sl4a 呼叫記錄 btsnoop 記錄

static boolean enable(ITestDevice device)

啟用指定裝置的藍牙功能

static boolean enableBtsnoopLogging(ITestDevice device, File sl4aApkFile)

啟用 sl4a 呼叫記錄 btsnoop 記錄

static boolean enableBtsnoopLogging(ITestDevice device)

啟用 sl4a 呼叫記錄 btsnoop 記錄

static String getBluetoothMac(ITestDevice device)

擷取指定裝置的 BT mac

static getBondedDevices(ITestDevice device)

傳回與指定裝置建立繫結的裝置藍牙 mac 位址

static String getBtSnoopLogFilePath(ITestDevice device)

從 bt_stack.config 檔案取得 bt 窺探記錄檔路徑

static String runBluetoothInstrumentation(ITestDevice device, String command)

執行 BT 檢測指令及傳回輸出內容的便利方法

static boolean runBluetoothInstrumentationWithRetry(ITestDevice device, String command)
static boolean toggleBtsnoopLogging(Sl4aClient client, boolean onOff)
static boolean unpairWithRetry(ITestDevice device)

重試 BT 配對與線性輪詢

static void uploadLogFiles(ITestInvocationListener listener, ITestDevice device, String type, int iteration)

上傳測試結果記錄檔

欄位

BTSNOOP_API

public static final String BTSNOOP_API

幕後花絮

public static final String BTSNOOP_CMD

BTSNOOP_DISABLE_CMD

public static final String BTSNOOP_DISABLE_CMD

BTSNOOP_ENABLE_CMD

public static final String BTSNOOP_ENABLE_CMD

GOLD_BTSNOOP_LOG_PATH

public static final String GOLD_BTSNOOP_LOG_PATH

O_BUILD

public static final String O_BUILD

公用建構函式

藍牙工具

public BluetoothUtils ()

公用方法

清除記錄檔

public static void cleanLogFile (ITestDevice device)

從裝置刪除窺探記錄檔

參數
device ITestDevice

擲回
DeviceNotAvailableException

停用

public static boolean disable (ITestDevice device)

停用指定裝置的藍牙功能

傳回
boolean 如果停用成功，則為「true」，否則傳回「false」
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

停用 Btsnoop 記錄

public static boolean disableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

停用 sl4a 呼叫記錄 btsnoop 記錄

參數
sl4aApkFile File：sl4a.apk 檔案位置，如果已安裝，則為空值
傳回
boolean 是否成功
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

停用 Btsnoop 記錄

public static boolean disableBtsnoopLogging (ITestDevice device)

停用 sl4a 呼叫記錄 btsnoop 記錄

傳回
boolean 是否成功
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

啟用

public static boolean enable (ITestDevice device)

啟用指定裝置的藍牙功能

傳回
boolean 如果啟用成功，則為「true」，否則傳回「false」
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableBtsnoop 記錄

public static boolean enableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

啟用 sl4a 呼叫記錄 btsnoop 記錄

參數
sl4aApkFile File：sl4a.apk 檔案位置，如果已安裝，則為空值
傳回
boolean 是否成功
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableBtsnoop 記錄

public static boolean enableBtsnoopLogging (ITestDevice device)

啟用 sl4a 呼叫記錄 btsnoop 記錄

傳回
boolean 是否成功
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

取得藍牙 Mac

public static String getBluetoothMac (ITestDevice device)

擷取指定裝置的 BT mac

傳回
String BT mac 或 null
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBondedDevice

public static  getBondedDevices (ITestDevice device)

傳回與指定裝置建立繫結的裝置藍牙 mac 位址

傳回
藍牙 mac 位址
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBtSnoopLogFilePath

public static String getBtSnoopLogFilePath (ITestDevice device)

從 bt_stack.config 檔案取得 bt 窺探記錄檔路徑

傳回
String bt_snoop_log 的 THe 檔案名稱，如果找不到，則為空值
擲回
DeviceNotAvailableException

執行 BluetoothInstrumentation

public static String runBluetoothInstrumentation (ITestDevice device, 
                String command)

執行 BT 檢測指令及傳回輸出內容的便利方法

參數
command String：傳送至 BT 檢測的指令字串，目前支援： enable、disable、unpairAll、getName、getAddress、getBondedDevices；提及 詳情請參閱 Android 開放原始碼計畫來源
傳回
String BluetoothInstrumentation 輸出內容
擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runBluetoothInstrumentationWith 重試

public static boolean runBluetoothInstrumentationWithRetry (ITestDevice device, 
                String command)

參數
device ITestDevice

command String

傳回
boolean

擲回
DeviceNotAvailableException

切換 Btsnoop 記錄

public static boolean toggleBtsnoopLogging (Sl4aClient client, 
                boolean onOff)

參數
client Sl4aClient

onOff boolean

傳回
boolean

擲回
DeviceNotAvailableException

解除配對

public static boolean unpairWithRetry (ITestDevice device)

重試 BT 配對與線性輪詢

傳回
boolean

擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

上傳記錄檔

public static void uploadLogFiles (ITestInvocationListener listener, 
                ITestDevice device, 
                String type, 
                int iteration)

上傳測試結果記錄檔

參數
listener ITestInvocationListener

device ITestDevice

type String

iteration int

擲回
DeviceNotAvailableException