112 lines
4.5 KiB
Java
112 lines
4.5 KiB
Java
/*
|
|
* Copyright (C) 2009 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package android.bluetooth;
|
|
|
|
import android.annotation.RequiresPermission;
|
|
import android.annotation.SdkConstant;
|
|
import android.annotation.SdkConstant.SdkConstantType;
|
|
import android.annotation.SuppressLint;
|
|
import android.annotation.SystemApi;
|
|
import android.bluetooth.annotations.RequiresBluetoothConnectPermission;
|
|
|
|
/**
|
|
* A helper to show a system "Device Picker" activity to the user.
|
|
*
|
|
* @hide
|
|
*/
|
|
@SystemApi
|
|
public interface BluetoothDevicePicker {
|
|
|
|
/**
|
|
* Extra for filter type used with {@link #ACTION_LAUNCH}.
|
|
* The value must be a boolean indicating whether the device should need authentication or not.
|
|
*/
|
|
@SuppressLint("ActionValue")
|
|
public static final String EXTRA_NEED_AUTH =
|
|
"android.bluetooth.devicepicker.extra.NEED_AUTH";
|
|
|
|
/**
|
|
* Extra for filter type used with {@link #ACTION_LAUNCH}.
|
|
* This extra must contain the filter type that will be applied to the device list.
|
|
* Possible values are {@link #FILTER_TYPE_ALL}, {@link #FILTER_TYPE_AUDIO},
|
|
* {@link #FILTER_TYPE_TRANSFER}, {@link #FILTER_TYPE_PANU}, and {@link #FILTER_TYPE_NAP}.
|
|
*/
|
|
@SuppressLint("ActionValue")
|
|
public static final String EXTRA_FILTER_TYPE =
|
|
"android.bluetooth.devicepicker.extra.FILTER_TYPE";
|
|
|
|
/**
|
|
* Extra for filter type used with {@link #ACTION_LAUNCH}.
|
|
* This extra must contain the package name that called {@link #ACTION_LAUNCH}.
|
|
*/
|
|
@SuppressLint("ActionValue")
|
|
public static final String EXTRA_LAUNCH_PACKAGE =
|
|
"android.bluetooth.devicepicker.extra.LAUNCH_PACKAGE";
|
|
|
|
/**
|
|
* Extra for filter type used with {@link #ACTION_LAUNCH}.
|
|
* This extra must contain the class name that called {@link #ACTION_LAUNCH}.
|
|
*/
|
|
@SuppressLint("ActionValue")
|
|
public static final String EXTRA_LAUNCH_CLASS =
|
|
"android.bluetooth.devicepicker.extra.DEVICE_PICKER_LAUNCH_CLASS";
|
|
|
|
/**
|
|
* Broadcast when one BT device is selected from BT device picker screen.
|
|
* Selected {@link BluetoothDevice} is returned in extra data named
|
|
* {@link BluetoothDevice#EXTRA_DEVICE}.
|
|
*/
|
|
@RequiresBluetoothConnectPermission
|
|
@RequiresPermission(android.Manifest.permission.BLUETOOTH_CONNECT)
|
|
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
|
|
@SuppressLint("ActionValue")
|
|
public static final String ACTION_DEVICE_SELECTED =
|
|
"android.bluetooth.devicepicker.action.DEVICE_SELECTED";
|
|
|
|
/**
|
|
* Broadcast when someone want to select one BT device from devices list.
|
|
* This intent contains below extra data:
|
|
* - {@link #EXTRA_NEED_AUTH} (boolean): if need authentication
|
|
* - {@link #EXTRA_FILTER_TYPE} (int): what kinds of device should be
|
|
* listed
|
|
* - {@link #EXTRA_LAUNCH_PACKAGE} (string): where(which package) this
|
|
* intent come from
|
|
* - {@link #EXTRA_LAUNCH_CLASS} (string): where(which class) this intent
|
|
* come from
|
|
*/
|
|
@RequiresBluetoothConnectPermission
|
|
@RequiresPermission(android.Manifest.permission.BLUETOOTH_CONNECT)
|
|
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
|
|
@SuppressLint("ActionValue")
|
|
public static final String ACTION_LAUNCH =
|
|
"android.bluetooth.devicepicker.action.LAUNCH";
|
|
|
|
/** Ask device picker to show all kinds of BT devices */
|
|
public static final int FILTER_TYPE_ALL = 0;
|
|
/** Ask device picker to show BT devices that support AUDIO profiles */
|
|
public static final int FILTER_TYPE_AUDIO = 1;
|
|
/** Ask device picker to show BT devices that support Object Transfer */
|
|
public static final int FILTER_TYPE_TRANSFER = 2;
|
|
/**
|
|
* Ask device picker to show BT devices that support
|
|
* Personal Area Networking User (PANU) profile
|
|
*/
|
|
public static final int FILTER_TYPE_PANU = 3;
|
|
/** Ask device picker to show BT devices that support Network Access Point (NAP) profile */
|
|
public static final int FILTER_TYPE_NAP = 4;
|
|
}
|