BluetoothDevice 클래스

정의

원격 Bluetooth 디바이스를 나타냅니다.

[Android.Runtime.Register("android/bluetooth/BluetoothDevice", DoNotGenerateAcw=true)]
public sealed class BluetoothDevice : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/bluetooth/BluetoothDevice", DoNotGenerateAcw=true)>]
type BluetoothDevice = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
상속
BluetoothDevice
특성
구현

설명

원격 Bluetooth 디바이스를 나타냅니다. A BluetoothDevice 를 사용하면 각 디바이스와의 연결을 만들거나 이름, 주소, 클래스 및 결합 상태와 같은 해당 디바이스에 대한 정보를 쿼리할 수 있습니다.

이 클래스는 실제로 Bluetooth 하드웨어 주소에 대한 씬 래퍼입니다. 이 클래스의 개체는 변경할 수 없습니다. 이 클래스에 대한 작업은 원격 Bluetooth 하드웨어 주소에서 수행되며, 이를 BluetoothDevice만드는 데 사용된 작업을 사용합니다BluetoothAdapter.

BluetoothDeviceBluetoothAdapter#getRemoteDevice(String) BluetoothAdapter.getRemoteDevice(String) 얻으려면 알려진 MAC 주소의 디바이스를 나타내는 디바이스를 만들거나(디바이스 검색을 BluetoothAdapter통해 가져올 수 있습니다) 에서 반환BluetoothAdapter#getBondedDevices() BluetoothAdapter.getBondedDevices()된 결합된 디바이스 집합에서 하나를 가져옵니다. 그런 다음, Bluetooth BR/EDR을 통해 또는 Bluetooth LE를 통해 사용하여 #createRfcommSocketToServiceRecord(UUID)#createL2capChannel(int) 원격 디바이스와의 통신을 위해 열 BluetoothSocket 수 있습니다.

<div class="special reference">

<h3>개발자 가이드</h3>

Bluetooth 사용에 대한 자세한 내용은 Bluetooth 개발자 가이드를 참조하세요. </Div>

에 대한 android.bluetooth.BluetoothDeviceJava 설명서

이 페이지의 일부는 만들고 공유한 작업을 기반으로 하며 에 설명된 조건에 따라 사용됩니다.

필드

Name Description
ActionAclConnected

브로드캐스트 작업: 원격 디바이스를 사용하여 ACL(하위 수준) 연결이 설정되었음을 나타냅니다.

ActionAclDisconnected

브로드캐스트 작업: 원격 디바이스에서 낮은 수준(ACL) 연결 끊김을 나타냅니다.

ActionAclDisconnectRequested

브로드캐스트 작업: 원격 디바이스에 대해 낮은 수준(ACL) 연결이 요청되었으며 곧 연결이 끊어지게 됨을 나타냅니다.

ActionAliasChanged

브로드캐스트 작업: 원격 디바이스의 별칭이 변경되었음을 나타냅니다.

ActionBondStateChanged

브로드캐스트 작업: 원격 디바이스의 채권 상태가 변경되었음을 나타냅니다.

ActionClassChanged

브로드캐스트 작업: 원격 디바이스의 Bluetooth 클래스가 변경되었습니다.

ActionEncryptionChange

브로드캐스트 작업: 암호화 상태가 변경되었음을 나타냅니다.

ActionFound

브로드캐스트 작업: 원격 디바이스가 검색되었습니다.

ActionKeyMissing

브로드캐스트 작업: 이전에 결합된 디바이스가 암호화를 설정하는 키를 제공할 수 없다는 것을 나타냅니다.

ActionNameChanged

브로드캐스트 작업: 원격 디바이스의 이름이 처음으로 검색되었거나 마지막 검색 이후 변경되었음을 나타냅니다.

ActionPairingRequest

브로드캐스트 작업: 이 의도는 PAIRING REQUEST를 브로드캐스트하는 데 사용됩니다.

ActionUuid

브로드캐스트 작업: 이 의도는 래핑된 디바이스를 android.os.ParcelUuid 가져온 후 원격 디바이스로 브로드캐 UUID 스트하는 데 사용됩니다.

AddressTypeAnonymous
사용되지 않음.

익명 광고를 나타내는 데 사용되는 주소 유형입니다.

AddressTypePublic
사용되지 않음.

디바이스의 하드웨어 MAC 주소

AddressTypeRandom
사용되지 않음.

주소는 확인 가능하거나, 확인할 수 없거나, 정적입니다.

AddressTypeUnknown
사용되지 않음.

주소 유형을 알 수 없거나 사용할 수 없음

DeviceTypeClassic
사용되지 않음.

Bluetooth 디바이스 유형, 클래식 - BR/EDR 디바이스

DeviceTypeDual
사용되지 않음.

Bluetooth 디바이스 유형, 이중 모드 - BR/EDR/LE

DeviceTypeLe
사용되지 않음.

Bluetooth 장치 유형, 저에너지 - LE 전용

DeviceTypeUnknown
사용되지 않음.

Bluetooth 장치 유형, 알 수 없음

EncryptionAlgorithmAes
사용되지 않음.

AES 알고리즘을 사용하여 링크가 암호화되었음을 나타냅니다.

EncryptionAlgorithmE0
사용되지 않음.

E0 알고리즘을 사용하여 링크가 암호화되었음을 나타냅니다.

EncryptionAlgorithmNone
사용되지 않음.

알고리즘을 사용하여 링크가 암호화되지 않음을 나타냅니다.

Error

이 클래스의 Sentinel 오류 값입니다.

ExtraBondState

의도에서 int 추가 필드로 #ACTION_BOND_STATE_CHANGED 사용됩니다.

ExtraClass

구획 가능한 BluetoothClass 추가 필드 및 #ACTION_CLASS_CHANGED 의도로 #ACTION_FOUND 사용됩니다.

ExtraDevice

이 클래스에서 브로드캐스트하는 모든 의도에서 구획 가능한 BluetoothDevice 추가 필드로 사용됩니다.

ExtraEncryptionAlgorithm

암호화에 사용되는 알고리즘으로 의도의 #ACTION_ENCRYPTION_CHANGE int 추가 필드로 사용됩니다.

ExtraEncryptionEnabled

의도에 부울 추가 필드로 #ACTION_ENCRYPTION_CHANGE 사용됩니다.

ExtraEncryptionStatus

의도에서 int 추가 필드로 #ACTION_ENCRYPTION_CHANGE 사용됩니다.

ExtraIsCoordinatedSetMember

의도에서 부울 추가 필드로 #ACTION_FOUND 사용됩니다.

ExtraKeySize

의도의 int 추가 필드 #ACTION_ENCRYPTION_CHANGE 로 암호화 키의 크기(바이트 수)로 사용됩니다.

ExtraName

문자열 추가 필드 및 #ACTION_FOUND 의도로 #ACTION_NAME_CHANGED 사용됩니다.

ExtraPairingKey

의도에서 int 추가 필드 #ACTION_PAIRING_REQUEST 로 암호 키 값으로 사용됩니다.

ExtraPairingVariant

사용되는 페어링 방법을 나타내기 위해 의도에서 #ACTION_PAIRING_REQUEST int 추가 필드로 사용됩니다.

ExtraPreviousBondState

의도에서 int 추가 필드로 #ACTION_BOND_STATE_CHANGED 사용됩니다.

ExtraRssi

의도에서 선택적 짧은 추가 필드로 #ACTION_FOUND 사용됩니다.

ExtraTransport

Int 추가 필드 #ACTION_ACL_CONNECTED#ACTION_ACL_DISCONNECTED 로 사용되며 #ACTION_ENCRYPTION_CHANGE 연결된 전송을 나타내기 위한 의도입니다.

ExtraUuid

의도에서 #ACTION_UUID 추가 필드로 사용되며, 구획 가능한 버전의 UUID원격 디바이스를 포함합니다android.os.ParcelUuid.

PairingVariantPasskeyConfirmation

사용자에게 화면에 표시되는 암호를 확인하라는 메시지가 표시되거나 앱에서 사용자의 암호를 확인합니다.

PairingVariantPin

사용자에게 핀을 입력하라는 메시지가 표시되거나 앱이 사용자에 대한 핀을 입력합니다.

속성

Name Description
Address

이 BluetoothDevice의 하드웨어 주소를 반환합니다.

AddressType

이 BluetoothDevice의 주소 유형, 즉 , #ADDRESS_TYPE_RANDOM#ADDRESS_TYPE_ANONYMOUS또는 #ADDRESS_TYPE_UNKNOWN. 중 #ADDRESS_TYPE_PUBLIC하나를 반환합니다.

Alias

원격 Bluetooth 디바이스의 로컬로 수정 가능한 이름(별칭)을 가져옵니다.

BluetoothClass

원격 디바이스의 Bluetooth 클래스를 가져옵니다.

BondState

원격 디바이스의 채권 상태를 가져옵니다.

Class

Object런타임 클래스를 반환합니다.

(다음에서 상속됨 Object)
Creator
Handle

기본 Android 인스턴스에 대한 핸들입니다.

(다음에서 상속됨 Object)
IdentityAddressWithType

원격 Bluetooth 디바이스를 나타냅니다.

JniIdentityHashCode

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
JniPeerMembers

원격 Bluetooth 디바이스를 나타냅니다.

Name

원격 디바이스의 친숙한 Bluetooth 이름을 가져옵니다.

PeerReference

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
ThresholdClass

이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.

(다음에서 상속됨 Object)
ThresholdType

이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다.

(다음에서 상속됨 Object)
Type

원격 디바이스의 Bluetooth 디바이스 유형을 가져옵니다.

메서드

Name Description
Clone()

이 개체의 복사본을 만들고 반환합니다.

(다음에서 상속됨 Object)
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy, Handler)

이 디바이스에서 호스트하는 GATT 서버에 연결합니다.

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy)

이 디바이스에서 호스트하는 GATT 서버에 연결합니다.

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy, Handler)
사용되지 않음.

원격 Bluetooth 디바이스를 나타냅니다.

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy)
사용되지 않음.

원격 Bluetooth 디바이스를 나타냅니다.

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports)

이 디바이스에서 호스트하는 GATT 서버에 연결합니다.

ConnectGatt(Context, Boolean, BluetoothGattCallback)

이 디바이스에서 호스트하는 GATT 서버에 연결합니다.

CreateBond()

원격 디바이스와 결합(페어링) 프로세스를 시작합니다.

CreateInsecureL2capChannel(Int32)

동일한 동적 프로토콜/서비스 멀티플렉서(PSM) BluetoothSocket 값을 사용하여 원격 디바이스에 대한 안전한 나가는 연결을 시작하는 데 사용할 수 있는 Bluetooth L2CAP 연결 지향 채널(CoC)을 만듭니다.

CreateInsecureRfcommSocketToServiceRecord(UUID)

uuid의 SDP 조회를 사용하여 이 원격 디바이스에 대한 안전하지 않은 나가는 연결을 시작할 준비가 된 RFCOMM BluetoothSocket 소켓을 만듭니다.

CreateL2capChannel(Int32)

동일한 동적 프로토콜/서비스 멀티플렉서(PSM) BluetoothSocket 값을 사용하여 원격 디바이스에 대한 안전한 나가는 연결을 시작하는 데 사용할 수 있는 Bluetooth L2CAP 연결 지향 채널(CoC)을 만듭니다.

CreateRfcommSocketToServiceRecord(UUID)

uuid의 SDP 조회를 사용하여 이 원격 디바이스에 대한 안전한 나가는 연결을 시작할 준비가 된 RFCOMM BluetoothSocket 을 만듭니다.

CreateUsingSocketSettings(BluetoothSocketSettings)

지정된 소켓 설정을 BluetoothSocketSettings 사용하여 원격 Bluetooth 서버에 연결할 클라이언트 소켓을 만듭니다. 이 API는 사용하여 BluetoothAdapter#listenUsingSocketSettings호스트되는 원격 서버에 연결하는 데 사용됩니다.

DescribeContents()

이 Parcelable의 마샬링된 표현에 포함된 특수 개체의 종류를 설명합니다.

Dispose()

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
Dispose(Boolean)

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
Equals(Object)

다른 개체가 이 개체와 "같음"인지 여부를 나타냅니다.

(다음에서 상속됨 Object)
FetchUuidsWithSdp()

원격 디바이스에서 서비스 검색을 수행하여 지원되는 UUID를 가져옵니다.

GetHashCode()

개체에 대한 해시 코드 값을 반환합니다.

(다음에서 상속됨 Object)
GetUuids()

원격 디바이스의 지원되는 기능(UUID)을 반환합니다.

JavaFinalize()

가비지 수집에서 개체에 대한 참조가 더 이상 없다고 판단할 때 개체의 가비지 수집기에서 호출됩니다.

(다음에서 상속됨 Object)
Notify()

이 개체의 모니터에서 대기 중인 단일 스레드를 해제합니다.

(다음에서 상속됨 Object)
NotifyAll()

이 개체의 모니터에서 대기 중인 모든 스레드를 해제합니다.

(다음에서 상속됨 Object)
SetAlias(String)

원격 Bluetooth 디바이스의 로컬로 수정 가능한 이름(별칭)을 설정합니다.

SetHandle(IntPtr, JniHandleOwnership)

Handle 속성을 설정합니다.

(다음에서 상속됨 Object)
SetPairingConfirmation(Boolean)

페어링에 대한 #PAIRING_VARIANT_PASSKEY_CONFIRMATION 암호를 확인합니다.

SetPin(Byte[])

페어링 방법일 때 페어링하는 동안 핀 설정 #PAIRING_VARIANT_PIN

ToArray<T>()

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
ToString()

개체의 문자열 표현을 반환합니다.

(다음에서 상속됨 Object)
UnregisterFromRuntime()

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
Wait()

현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <알림을 받<>거나 <><중단/종료>합니다.>

(다음에서 상속됨 Object)
Wait(Int64, Int32)

현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <>알림을 받<거나 <중단/>종료><>하거나 일정량의 실시간 경과가 발생할 때까지 대기합니다.

(다음에서 상속됨 Object)
Wait(Int64)

현재 스레드가 각성될 때까지 대기하게 하며, 일반적으로 <>알림을 받<거나 <중단/>종료><>하거나 일정량의 실시간 경과가 발생할 때까지 대기합니다.

(다음에서 상속됨 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

이 개체를 구획에 평면화합니다.

명시적 인터페이스 구현

Name Description
IJavaPeerable.Disposed()

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
IJavaPeerable.DisposeUnlessReferenced()

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
IJavaPeerable.Finalized()

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
IJavaPeerable.JniManagedPeerState

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

원격 Bluetooth 디바이스를 나타냅니다.

(다음에서 상속됨 Object)

확장명 메서드

Name Description
GetJniTypeName(IJavaPeerable)

인스턴스 self형식의 JNI 이름을 가져옵니다.

JavaAs<TResult>(IJavaPeerable)

형식TResult을 강제 self 변환하여 강제 변환이 Java 쪽에서 유효한지 확인합니다.

JavaCast<TResult>(IJavaObject)

Android 런타임 확인 형식 변환을 수행합니다.

JavaCast<TResult>(IJavaObject)

원격 Bluetooth 디바이스를 나타냅니다.

TryJavaCast<TResult>(IJavaPeerable, TResult)

형식TResult을 강제 self 변환하여 강제 변환이 Java 쪽에서 유효한지 확인합니다.

적용 대상