7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept xml:lang="en" id="GUID-2F1C6B4C-2C23-5A35-A0D2-223EC6238F7D"><title>Bluetooth Service Discovery Agent Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><section><title>Purpose</title> <p>Enables you to discover the Bluetooth services, and the attributes of those services, that are available on a remote device. </p> </section> <section><title>Architectural relationships</title> <p>The Service Discovery Agent API is one of two APIs that enable you to use the Bluetooth Service Discovery Protocol. The other, the <xref href="GUID-756D831F-F302-594C-8116-144358DD8442.dita">Bluetooth Service Discovery Database</xref>, enables a local service to enter its own properties into a local service database. </p> </section> <section><title>Description</title> <p> <xref href="GUID-6A33D6A1-63C8-3A15-A2BC-5D08F07C5AB6.dita"><apiname>CSdpAgent</apiname></xref> is used to make Symbian OS Bluetooth SDP requests to a remote device. There are two basic queries you can make using it: </p> <ul><li id="GUID-F1360383-5474-5FE6-BEFD-29FCE6954C89"><p>Getting the services on the remote device and setting the classes of service for which you want to query using a <xref href="GUID-745D8374-1012-356B-A15E-6CBC96E64E95.dita"><apiname>CSdpSearchPattern</apiname></xref> object </p> </li> <li id="GUID-4FDB699D-E73A-53C7-943C-830D88E3B6F8"><p>Getting the attributes for a specific service and setting a list of attributes to be retrieved using a <xref href="GUID-7DA0506B-F2C1-374B-847F-8DF070BD2FE9.dita"><apiname>CSdpAttrIdMatchList</apiname></xref> object </p> </li> </ul> <p>An application using of <xref href="GUID-6A33D6A1-63C8-3A15-A2BC-5D08F07C5AB6.dita"><apiname>CSdpAgent</apiname></xref> must implement the interface <xref href="GUID-AD76DB7F-CD45-3903-A07A-E94BE583CDB0.dita"><apiname>MSdpAgentNotifier</apiname></xref> to receive the responses to queries. </p> <p>The API also supplies <xref href="GUID-3DE5145D-4D19-3439-A08C-58C0F504B24F.dita"><apiname>CElementParser</apiname></xref>, to parse a raw input buffer containing an attribute value into its constituent data elements. </p> </section> <section><title>Using the Bluetooth Service Discovery Agent</title> <p>The following tutorials will help get you started using the Bluetooth SDP Service Discovery Agent. </p> <ul><li id="GUID-5E4CE295-C84A-58D2-9078-365BF108F07A"><p> <xref href="GUID-275D7892-EEBD-5DBD-A9D7-F6A715B79659.dita">Querying the SDP database</xref> </p> </li> <li id="GUID-810282C3-5B8D-5E38-A4BE-2095A9BD2853"><p> <xref href="GUID-1EA7B3A5-7A94-5E8F-A0A8-9CA417E14032.dita">Reading remote SDP service attributes</xref> </p> </li> <li id="GUID-E75D9121-10E5-5060-A8F6-E8E79BB5AD9B"><p> <xref href="GUID-65F8675F-FF08-5707-BA5B-BF3B4B779393.dita">Handling SDP query results</xref> </p> </li> </ul> </section> </conbody></concept> |
12 <concept id="GUID-2F1C6B4C-2C23-5A35-A0D2-223EC6238F7D" xml:lang="en"><title>Bluetooth |
|
13 Service Discovery Agent Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <section id="GUID-41E66AB1-E555-43D5-BCA3-FB8D9DB6202E"><title>Purpose</title> <p>Enables you to discover the Bluetooth services, |
|
15 and the attributes of those services, that are available on a remote device. </p> </section> |
|
16 <section id="GUID-C4E439FA-9081-44A8-8328-686829401409"><title>Architectural relationships</title> <p>The Service Discovery |
|
17 Agent API is one of two APIs that enable you to use the Bluetooth Service |
|
18 Discovery Protocol. The other, the <xref href="GUID-756D831F-F302-594C-8116-144358DD8442.dita">Bluetooth |
|
19 Service Discovery Database</xref>, enables a local service to enter its own |
|
20 properties into a local service database. </p> </section> |
|
21 <section id="GUID-FB03079D-D167-444E-8833-0F852A0FC8C4"><title>Description</title> <p> <xref href="GUID-6A33D6A1-63C8-3A15-A2BC-5D08F07C5AB6.dita"><apiname>CSdpAgent</apiname></xref> is used |
|
22 to make Symbian platform Bluetooth SDP requests to a remote device. |
|
23 There are two basic queries you can make using it: </p> <ul> |
|
24 <li id="GUID-F1360383-5474-5FE6-BEFD-29FCE6954C89"><p>Getting the services |
|
25 on the remote device and setting the classes of service for which you want |
|
26 to query using a <xref href="GUID-745D8374-1012-356B-A15E-6CBC96E64E95.dita"><apiname>CSdpSearchPattern</apiname></xref> object </p> </li> |
|
27 <li id="GUID-4FDB699D-E73A-53C7-943C-830D88E3B6F8"><p>Getting the attributes |
|
28 for a specific service and setting a list of attributes to be retrieved using |
|
29 a <xref href="GUID-7DA0506B-F2C1-374B-847F-8DF070BD2FE9.dita"><apiname>CSdpAttrIdMatchList</apiname></xref> object </p> </li> |
|
30 </ul> <p>An application using of <xref href="GUID-6A33D6A1-63C8-3A15-A2BC-5D08F07C5AB6.dita"><apiname>CSdpAgent</apiname></xref> must implement |
|
31 the interface <xref href="GUID-AD76DB7F-CD45-3903-A07A-E94BE583CDB0.dita"><apiname>MSdpAgentNotifier</apiname></xref> to receive the responses |
|
32 to queries. </p> <p>The API also supplies <xref href="GUID-3DE5145D-4D19-3439-A08C-58C0F504B24F.dita"><apiname>CElementParser</apiname></xref>, |
|
33 to parse a raw input buffer containing an attribute value into its constituent |
|
34 data elements. </p> </section> |
|
35 <section id="GUID-614FABFF-4E43-4478-92CA-E9DF808D9A05"><title>Using the Bluetooth Service Discovery Agent</title> <p>The |
|
36 following tutorials will help get you started using the Bluetooth SDP Service |
|
37 Discovery Agent. </p> <ul> |
|
38 <li id="GUID-5E4CE295-C84A-58D2-9078-365BF108F07A"><p> <xref href="GUID-275D7892-EEBD-5DBD-A9D7-F6A715B79659.dita">Querying |
|
39 the SDP database</xref> </p> </li> |
|
40 <li id="GUID-810282C3-5B8D-5E38-A4BE-2095A9BD2853"><p> <xref href="GUID-1EA7B3A5-7A94-5E8F-A0A8-9CA417E14032.dita">Reading |
|
41 remote SDP service attributes</xref> </p> </li> |
|
42 <li id="GUID-E75D9121-10E5-5060-A8F6-E8E79BB5AD9B"><p> <xref href="GUID-65F8675F-FF08-5707-BA5B-BF3B4B779393.dita">Handling |
|
43 SDP query results</xref> </p> </li> |
|
44 </ul> </section> |
|
45 </conbody></concept> |