|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DiscoveryListener
The DiscoveryListener
interface allows an application to receive
device discovery and service discovery events. This interface provides four
methods, two for discovering devices and two for discovering services.
The JSR 82 specification does not require that implementations create
individual threads for event delivery. Thus, if a DiscoveryListener method
does not return or the return is delayed, the system may be blocked. So the
following note is given for application developers :
The following DiscoveryListener methods SHOULD return immediately :
DiscoveryListener.deviceDiscovered
DiscoveryListener.inquiryCompleted
DiscoveryListener.servicesDiscovered
DiscoveryListener.serviceSearchCompleted
Field Summary | |
---|---|
static int |
INQUIRY_COMPLETED
Indicates the normal completion of device discovery. |
static int |
INQUIRY_ERROR
Indicates that the inquiry request failed to complete normally, but was not cancelled. |
static int |
INQUIRY_TERMINATED
Indicates device discovery has been canceled by the application and did not complete. |
static int |
SERVICE_SEARCH_COMPLETED
Indicates the normal completion of service discovery. |
static int |
SERVICE_SEARCH_DEVICE_NOT_REACHABLE
Indicates the service search could not be completed because the remote device provided to DiscoveryAgent.searchServices() could not be reached. |
static int |
SERVICE_SEARCH_ERROR
Indicates the service search terminated with an error. |
static int |
SERVICE_SEARCH_NO_RECORDS
Indicates the service search has completed with no service records found on the device. |
static int |
SERVICE_SEARCH_TERMINATED
Indicates the service search has been canceled by the application and did not complete. |
Method Summary | |
---|---|
void |
deviceDiscovered(RemoteDevice btDevice,
DeviceClass cod)
Called when a device is found during an inquiry. |
void |
inquiryCompleted(int discType)
Called when an inquiry is completed. |
void |
servicesDiscovered(int transID,
ServiceRecord[] servRecord)
Called when service(s) are found during a service search. |
void |
serviceSearchCompleted(int transID,
int respCode)
Called when a service search is completed or was terminated because of an error. |
Field Detail |
---|
static final int INQUIRY_COMPLETED
inquiryCompleted(int)
method.
The value of INQUIRY_COMPLETED is 0x00 (0).
inquiryCompleted(int)
,
DiscoveryAgent.startInquiry(int, javax.bluetooth.DiscoveryListener)
,
Constant Field Valuesstatic final int INQUIRY_TERMINATED
inquiryCompleted(int)
method.
The value of INQUIRY_TERMINATED is 0x05 (5).
inquiryCompleted(int)
,
DiscoveryAgent.startInquiry(int, javax.bluetooth.DiscoveryListener)
,
DiscoveryAgent.cancelInquiry(javax.bluetooth.DiscoveryListener)
,
Constant Field Valuesstatic final int INQUIRY_ERROR
The value of INQUIRY_ERROR is 0x07 (7).
inquiryCompleted(int)
,
DiscoveryAgent.startInquiry(int, javax.bluetooth.DiscoveryListener)
,
Constant Field Valuesstatic final int SERVICE_SEARCH_COMPLETED
serviceSearchCompleted(int, int)
method.
The value of SERVICE_SEARCH_COMPLETED is 0x01 (1).
serviceSearchCompleted(int, int)
,
DiscoveryAgent.searchServices(int[], javax.bluetooth.UUID[],
javax.bluetooth.RemoteDevice, javax.bluetooth.DiscoveryListener)
,
Constant Field Valuesstatic final int SERVICE_SEARCH_TERMINATED
serviceSearchCompleted(int, int)
method.
The value of SERVICE_SEARCH_TERMINATED is 0x02 (2).
serviceSearchCompleted(int, int)
,
DiscoveryAgent.searchServices(int[], javax.bluetooth.UUID[],
javax.bluetooth.RemoteDevice, javax.bluetooth.DiscoveryListener)
,
DiscoveryAgent.cancelServiceSearch(int)
,
Constant Field Valuesstatic final int SERVICE_SEARCH_ERROR
serviceSearchCompleted(int, int)
method.
The value of SERVICE_SEARCH_ERROR is 0x03 (3).
serviceSearchCompleted(int, int)
,
DiscoveryAgent.searchServices(int[], javax.bluetooth.UUID[],
javax.bluetooth.RemoteDevice, javax.bluetooth.DiscoveryListener)
,
Constant Field Valuesstatic final int SERVICE_SEARCH_NO_RECORDS
serviceSearchCompleted(int, int)
method.
The value of SERVICE_SEARCH_NO_RECORDS is 0x04 (4).
serviceSearchCompleted(int, int)
,
DiscoveryAgent.searchServices(int[], javax.bluetooth.UUID[],
javax.bluetooth.RemoteDevice, javax.bluetooth.DiscoveryListener)
,
Constant Field Valuesstatic final int SERVICE_SEARCH_DEVICE_NOT_REACHABLE
DiscoveryAgent.searchServices()
could not be reached.
Used with the serviceSearchCompleted(int, int)
method.
The value of SERVICE_SEARCH_DEVICE_NOT_REACHABLE is 0x06 (6).
serviceSearchCompleted(int, int)
,
DiscoveryAgent.searchServices(int[], javax.bluetooth.UUID[],
javax.bluetooth.RemoteDevice, javax.bluetooth.DiscoveryListener)
,
Constant Field ValuesMethod Detail |
---|
void deviceDiscovered(RemoteDevice btDevice, DeviceClass cod)
DiscoveryListener.deviceDiscovered()
method only once for each
individual discovered remote device.
btDevice
- the device that was found during the inquirycod
- - the service classes, major device class, and minor device
class of the remote deviceDiscoveryAgent.startInquiry(int, javax.bluetooth.DiscoveryListener)
void servicesDiscovered(int transID, ServiceRecord[] servRecord)
transID
- the transaction ID of the service search that is posting the
resultservRecord
- a list of services found during the search requestDiscoveryAgent.searchServices(int[], javax.bluetooth.UUID[],
javax.bluetooth.RemoteDevice, javax.bluetooth.DiscoveryListener)
void serviceSearchCompleted(int transID, int respCode)
respCode
argument include
SERVICE_SEARCH_COMPLETED
, SERVICE_SEARCH_TERMINATED
,
SERVICE_SEARCH_ERROR
, SERVICE_SEARCH_NO_RECORDS
and
SERVICE_SEARCH_DEVICE_NOT_REACHABLE
. The following table describes when
each respCode
will be used:
respCode | Reason |
---|---|
SERVICE_SEARCH_COMPLETED |
if the service search completed normally |
SERVICE_SEARCH_TERMINATED |
if the service search request was cancelled by a call to
DiscoveryAgent.cancelServiceSearch(int) |
SERVICE_SEARCH_ERROR |
if an error occurred while processing the request |
SERVICE_SEARCH_NO_RECORDS |
if no records were found during the service search |
SERVICE_SEARCH_DEVICE_NOT_REACHABLE |
if the device specified in the search request could not be reached or the local device could not establish a connection to the remote device |
transID
- the transaction ID identifying the request which
initiated the service searchrespCode
- the response code that indicates the status of the transactionvoid inquiryCompleted(int discType)
discType
will be
INQUIRY_COMPLETED
if the inquiry ended normally or INQUIRY_TERMINATED
if the inquiry was canceled by a call to
DiscoveryAgent.cancelInquiry(DiscoveryListener)
. The discType
will be
INQUIRY_ERROR
if an error occurred while processing the inquiry causing the
inquiry to end abnormally.
discType
- the type of request that was completed; either
INQUIRY_COMPLETED
, INQUIRY_TERMINATED
,
or INQUIRY_ERROR
INQUIRY_COMPLETED
,
INQUIRY_TERMINATED
,
INQUIRY_ERROR
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |