Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BluetoothHciSnoopLogCollector

public class BluetoothHciSnoopLogCollector
extends FilePullerDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector
		↳	com.android.tradefed.device.metric.BluetoothHciSnoopLogCollector

Coletor para ativar o registro de rastreamento do HCI Bluetooth no DUT e coletar o registro de cada teste. O coletor vai configurar e ativar o registro de rastreamento para a execução do teste e reverter as configurações após a execução.

Resumo

Constantes
`String`	`SNOOP_LOG_MODE_PROPERTY`

Construtores públicos
`BluetoothHciSnoopLogCollector()`

Métodos públicos
`String`	`getReportingDir()` Recupera o diretório para informar os registros de rastreamento do HCI.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback quando um caso de teste é encerrado.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback quando a execução de um teste é encerrada.
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando a execução de um teste é iniciada.
`void`	`onTestStart(DeviceMetricData testData)` Callback quando um caso de teste é iniciado.
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` A implementação do método precisa permitir registrar o diretório e analisá-lo para que as métricas sejam colocadas em `DeviceMetricData`.
`final void`	`processMetricFile(String key, File metricFile, DeviceMetricData runData)` A implementação do método precisa permitir registrar o arquivo e analisá-lo para que as métricas sejam colocadas em `DeviceMetricData`.

Métodos protegidos
`void`	`executeShellCommand(ITestDevice device, String command)` Executa o comando do shell no dispositivo.

Constantes

SNOOP_LOG_MODE_PROPERTY

public static final String SNOOP_LOG_MODE_PROPERTY

Valor da constante: "persist.bluetooth.btsnooplogmode"

Construtores públicos

BluetoothHciSnoopLogCollector

public BluetoothHciSnoopLogCollector ()

Métodos públicos

getReportingDir

public String getReportingDir ()

Recupera o diretório para informar os registros de rastreamento do HCI.

Retorna
`String`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Callback quando um caso de teste é encerrado. Esse é o momento de fazer a limpeza.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste. Será o mesmo objeto em `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: o mapa atual de métricas transmitido para `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

Gera
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Callback quando a execução de um teste é encerrada. Esse é o momento de fazer a limpeza.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados da execução. Será o mesmo objeto em `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: o mapa atual de métricas transmitido para `testRunEnded(long,Map)`.

Gera
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback quando a execução de um teste é iniciada.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados da execução.

Gera
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback quando um caso de teste é iniciado.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste.

Gera
`DeviceNotAvailableException`

processMetricDirectory

public void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData runData)

A implementação do método precisa permitir registrar o diretório e analisá-lo para que as métricas sejam colocadas em DeviceMetricData.

Parâmetros
`key`	`String`: a chave de opção associada ao diretório extraído.
`metricDirectory`	`File`: o `File` extraído do dispositivo que corresponde à chave de opção.
`runData`	`DeviceMetricData`: o `DeviceMetricData` em que as métricas podem ser armazenadas.

processMetricFile

public final void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData runData)

A implementação do método precisa permitir registrar o arquivo e analisá-lo para que as métricas sejam colocadas em DeviceMetricData.

Parâmetros
`key`	`String`: a chave de opção associada ao arquivo extraído.
`metricFile`	`File`: o `File` extraído do dispositivo que corresponde à chave de opção.
`runData`	`DeviceMetricData`: o `DeviceMetricData` em que as métricas podem ser armazenadas.

Métodos protegidos

executeShellCommand

protected void executeShellCommand (ITestDevice device, 
                String command)

Executa o comando do shell no dispositivo. Se a execução falhar (código de saída diferente de zero), gere uma DeviceRuntimeException.

Parâmetros
`device`	`ITestDevice`
`command`	`String`

Gera
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`