diff --git a/docs/html/about/versions/android-4.0.jd b/docs/html/about/versions/android-4.0.jd index 2fa180c5ad171..c026534779c89 100644 --- a/docs/html/about/versions/android-4.0.jd +++ b/docs/html/about/versions/android-4.0.jd @@ -62,7 +62,7 @@ class="toggle-content-img" alt="" />
  • Multimedia
  • Camera
  • Android Beam (NDEF Push with NFC)
    • -
  • Wi-Fi Direct
    • +
  • Wi-Fi P2P
  • Bluetooth Health Devices
  • Accessibility
  • Spell Checker Services
    • @@ -617,12 +617,13 @@ Beam Demo.

    -

    Wi-Fi Direct

    +

    Wi-Fi P2P

    -

    Android now supports Wi-Fi Direct for peer-to-peer (P2P) connections between Android-powered -devices and other device types without a hotspot or Internet connection. The Android framework +

    Android now supports Wi-Fi peer-to-peer (P2P) connections between Android-powered +devices and other device types (in compliance with the Wi-Fi +Alliance's Wi-Fi Direct™ certification program) without a hotspot or Internet connection. The Android framework provides a set of Wi-Fi P2P APIs that allow you to discover and connect to other devices when each -device supports Wi-Fi Direct, then communicate over a speedy connection across distances much longer +device supports Wi-Fi P2P, then communicate over a speedy connection across distances much longer than a Bluetooth connection.

    A new package, {@link android.net.wifi.p2p}, contains all the APIs for performing peer-to-peer @@ -669,7 +670,7 @@ formed and who is the group owner.

  • {@link android.Manifest.permission#ACCESS_WIFI_STATE}
  • {@link android.Manifest.permission#CHANGE_WIFI_STATE}
  • {@link android.Manifest.permission#INTERNET} (although your app doesn’t technically connect -to the Internet, communicating to Wi-Fi Direct peers with standard java sockets requires Internet +to the Internet, communicating to Wi-Fi P2P peers with standard java sockets requires Internet permission).
    • @@ -696,7 +697,7 @@ this device have changed.

    See the {@link android.net.wifi.p2p.WifiP2pManager} documentation for more information. Also -look at the Wi-Fi Direct Demo +look at the Wi-Fi P2P Demo sample application.

    diff --git a/docs/html/about/versions/android-4.1.jd b/docs/html/about/versions/android-4.1.jd index d4b9ebfee460a..76b90acdeb600 100644 --- a/docs/html/about/versions/android-4.1.jd +++ b/docs/html/about/versions/android-4.1.jd @@ -41,7 +41,7 @@ sdk.platform.apiLevel=16
    1. Android Beam
    2. Network service discovery
      3. -
    3. Wi-Fi Direct service discovery
      4. +
    4. Wi-Fi P2P service discovery
    5. Network usage
    @@ -506,11 +506,11 @@ discovered service, allowing you to initiate the connection.

    -

    Wi-Fi Direct service discovery

    +

    Wi-Fi P2P service discovery

    -

    The Wi-Fi Direct APIs are enhanced in Android 4.1 to support pre-association service discovery in +

    The Wi-Fi P2P APIs are enhanced in Android 4.1 to support pre-association service discovery in the {@link android.net.wifi.p2p.WifiP2pManager}. This allows you to discover and filter nearby -devices by services using Wi-Fi Direct before connecting to one, while Network Service +devices by services using Wi-Fi P2P before connecting to one, while Network Service Discovery allows you to discover a service on an existing connected network (such as a local Wi-Fi network).

    diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index 2a313748744a0..21d295a7ecff3 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -408,7 +408,7 @@
  • - Wi-Fi Direct + Wi-Fi P2P
  • diff --git a/docs/html/guide/topics/connectivity/wifip2p.jd b/docs/html/guide/topics/connectivity/wifip2p.jd index 2167a0ff986e5..7cadde1cf06aa 100644 --- a/docs/html/guide/topics/connectivity/wifip2p.jd +++ b/docs/html/guide/topics/connectivity/wifip2p.jd @@ -1,5 +1,5 @@ -page.title=Wi-Fi Direct -page.tags="wireless","WifiP2pManager" +page.title=Wi-Fi Peer-to-Peer +page.tags="wireless","WifiP2pManager","Wi-Fi Direct","WiFi Direct","P2P","Wi-Fi P2P","WiFi P2P" @jd:body @@ -9,10 +9,10 @@ page.tags="wireless","WifiP2pManager"
    1. API Overview
      2. -
    2. Creating a Broadcast Receiver for Wi-Fi Direct Intents
      3. +
    3. Creating a Broadcast Receiver for Wi-Fi P2P Intents
    4. - Creating a Wi-Fi Direct Application + Creating a Wi-Fi P2P Application
      1. Initial setup
        2. @@ -25,21 +25,24 @@ page.tags="wireless","WifiP2pManager"
    -

    Related Samples

    -
      -
    1. Wi-Fi Direct Demo
      2. -
    +

    See also

    +
    -

    Wi-Fi Direct allows Android 4.0 (API level 14) or later devices with the appropriate hardware - to connect directly to each other via Wi-Fi without an intermediate access point. - Using these APIs, you can discover and connect to other devices when each device supports Wi-Fi Direct, - then communicate over a speedy connection across distances much longer than a Bluetooth connection. - This is useful for applications that share data among users, such as a multiplayer game or - a photo sharing application.

    -

    The Wi-Fi Direct APIs consist of the following main parts:

    +

    Wi-Fi peer-to-peer (P2P) allows Android 4.0 (API level 14) or later devices with the appropriate +hardware to connect directly to each other via Wi-Fi without an intermediate access point (Android's +Wi-Fi P2P framework complies with the Wi-Fi Alliance's Wi-Fi Direct™ certification program). +Using these APIs, you can discover and connect to other devices when each device supports Wi-Fi P2P, +then communicate over a speedy connection across distances much longer than a Bluetooth connection. +This is useful for applications that share data among users, such as a multiplayer game or +a photo sharing application.

    + +

    The Wi-Fi P2P APIs consist of the following main parts:

    @@ -70,7 +73,7 @@ page.tags="wireless","WifiP2pManager" the Wi-Fi hardware on your device to do things like discover and connect to peers. The following actions are available:

    -

    Table 1.Wi-Fi Direct Methods

    +

    Table 1.Wi-Fi P2P Methods

    @@ -80,7 +83,7 @@ page.tags="wireless","WifiP2pManager" - + @@ -126,12 +129,12 @@ page.tags="wireless","WifiP2pManager"

    {@link android.net.wifi.p2p.WifiP2pManager} methods let you pass in a listener, - so that the Wi-Fi Direct framework can notify your + so that the Wi-Fi P2P framework can notify your activity of the status of a call. The available listener interfaces and the corresponding {@link android.net.wifi.p2p.WifiP2pManager} method calls that use the listeners are described in the following table:

    -

    Table 2. Wi-Fi Direct Listeners

    +

    Table 2. Wi-Fi P2P Listeners

    {@link android.net.wifi.p2p.WifiP2pManager#initialize initialize()}Registers the application with the Wi-Fi framework. This must be called before calling any other Wi-Fi Direct method.Registers the application with the Wi-Fi framework. This must be called before calling any other Wi-Fi P2P method.
    @@ -168,12 +171,12 @@ page.tags="wireless","WifiP2pManager"
    -

    The Wi-Fi Direct APIs define intents that are broadcast when certain Wi-Fi Direct events happen, +

    The Wi-Fi P2P APIs define intents that are broadcast when certain Wi-Fi P2P events happen, such as when a new peer is discovered or when a device's Wi-Fi state changes. You can register to receive these intents in your application by creating a broadcast receiver that handles these intents:

    -

    Table 3. Wi-Fi Direct Intents

    +

    Table 3. Wi-Fi P2P Intents

    @@ -194,7 +197,7 @@ page.tags="wireless","WifiP2pManager" - + @@ -204,11 +207,11 @@ page.tags="wireless","WifiP2pManager" -

    Creating a Broadcast Receiver for Wi-Fi Direct Intents

    +

    Creating a Broadcast Receiver for Wi-Fi P2P Intents

    A broadcast receiver allows you to receive intents broadcast by the Android system, so that your application can respond to events that you are interested in. The basic steps - for creating a broadcast receiver to handle Wi-Fi Direct intents are as follows:

    + for creating a broadcast receiver to handle Wi-Fi P2P intents are as follows:

    1. Create a class that extends the {@link android.content.BroadcastReceiver} class. For the @@ -267,17 +270,17 @@ public class WiFiDirectBroadcastReceiver extends BroadcastReceiver { } -

      Creating a Wi-Fi Direct Application

      +

      Creating a Wi-Fi P2P Application

      -

      Creating a Wi-Fi Direct application involves creating and registering a +

      Creating a Wi-Fi P2P application involves creating and registering a broadcast receiver for your application, discovering peers, connecting to a peer, and transferring data to a peer. The following sections describe how to do this.

      Initial setup

      -

      Before using the Wi-Fi Direct APIs, you must ensure that your application can access - the hardware and that the device supports the Wi-Fi Direct protocol. If Wi-Fi Direct is supported, +

      Before using the Wi-Fi P2P APIs, you must ensure that your application can access + the hardware and that the device supports the Wi-Fi P2P protocol. If Wi-Fi P2P is supported, you can obtain an instance of {@link android.net.wifi.p2p.WifiP2pManager}, create and register - your broadcast receiver, and begin using the Wi-Fi Direct APIs.

      + your broadcast receiver, and begin using the Wi-Fi P2P APIs.

      1. Request permission to use the Wi-Fi hardware on the device and also declare @@ -292,10 +295,10 @@ public class WiFiDirectBroadcastReceiver extends BroadcastReceiver {

        2. -
      2. Check to see if Wi-Fi Direct is on and supported. A good place to check this is in your +
      3. Check to see if Wi-Fi P2P is on and supported. A good place to check this is in your broadcast receiver when it receives the {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_STATE_CHANGED_ACTION} intent. Notify your - activity of the Wi-Fi Direct state and react accordingly: + activity of the Wi-Fi P2P state and react accordingly: 
         @Override
 public void onReceive(Context context, Intent intent) {
@@ -304,9 +307,9 @@ public void onReceive(Context context, Intent intent) {
     if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
         int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1);
         if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) {
-            // Wifi Direct is enabled
+            // Wifi P2P is enabled
         } else {
-            // Wi-Fi Direct is not enabled
+            // Wi-Fi P2P is not enabled
         }
     }
     ...
@@ -315,10 +318,10 @@ public void onReceive(Context context, Intent intent) {
      4. In your activity's {@link android.app.Activity#onCreate onCreate()} method, obtain an instance of {@link - android.net.wifi.p2p.WifiP2pManager} and register your application with the Wi-Fi Direct + android.net.wifi.p2p.WifiP2pManager} and register your application with the Wi-Fi P2P framework by calling {@link android.net.wifi.p2p.WifiP2pManager#initialize initialize()}. This method returns a {@link android.net.wifi.p2p.WifiP2pManager.Channel}, which is used to connect - your application to the Wi-Fi Direct framework. You should also create an instance of your + your application to the Wi-Fi P2P framework. You should also create an instance of your broadcast receiver with the {@link android.net.wifi.p2p.WifiP2pManager} and {@link android.net.wifi.p2p.WifiP2pManager.Channel} objects along with a reference to your activity. This allows your broadcast receiver to notify @@ -376,11 +379,11 @@ protected void onPause() {

        When you have obtained a {@link android.net.wifi.p2p.WifiP2pManager.Channel} and - set up a broadcast receiver, your application can make Wi-Fi Direct method calls and receive - Wi-Fi Direct intents.

        + set up a broadcast receiver, your application can make Wi-Fi P2P method calls and receive + Wi-Fi P2P intents.

        5. -

        You can now implement your application and use the Wi-Fi Direct features by calling the +

        You can now implement your application and use the Wi-Fi P2P features by calling the methods in {@link android.net.wifi.p2p.WifiP2pManager}. The next sections describe how to do common actions such as discovering and connecting to peers.

      @@ -492,10 +495,10 @@ mManager.connect(mChannel, config, new ActionListener() {

    The following example, modified from the Wi-Fi Direct Demo sample, shows you how + "{@docRoot}resources/samples/WiFiDirectDemo/index.html">Wi-Fi P2P Demo sample, shows you how to create this client-server socket communication and transfer JPEG images from a client to a server with a service. For a complete working example, compile and run the Wi-Fi Direct Demo sample.

    + "{@docRoot}resources/samples/WiFiDirectDemo/index.html">Wi-Fi P2P Demo sample.

     public static class FileServerAsyncTask extends AsyncTask {
 
diff --git a/docs/html/training/connect-devices-wirelessly/index.jd b/docs/html/training/connect-devices-wirelessly/index.jd
index f27b9c39d9635..db79abe6733fe 100644
--- a/docs/html/training/connect-devices-wirelessly/index.jd
+++ b/docs/html/training/connect-devices-wirelessly/index.jd
@@ -17,7 +17,7 @@ startpage=true
 
 
    You should also read
    
 
 
 
@@ -37,8 +37,8 @@ other machines on the same network.
    
 
    This class describes the key APIs for finding and
 connecting to other devices from your application.  Specifically, it
 describes the NSD API for discovering available services and the Wi-Fi
-Direct™ API for doing peer-to-peer wireless connections.  This class also
-shows you how to use NSD and Wi-Fi Direct in
+Peer-to-Peer (P2P) API for doing peer-to-peer wireless connections.  This class also
+shows you how to use NSD and Wi-Fi P2P in
 combination to detect the services offered by a device and connect to the
 device when neither device is connected to a network.
 
    
@@ -49,13 +49,13 @@ device when neither device is connected to a network.
   
    Learn how to broadcast services offered by your own application, discover
   services offered on the local network, and use NSD to determine the connection
   details for the service you wish to connect to.
    
-  
    Connecting with Wi-Fi Direct
    
+  
    Creating P2P Connections with Wi-Fi
    
   
    Learn how to fetch a list of nearby peer devices, create an access point
-  for legacy devices, and connect to other devices capable of Wi-Fi Direct
+  for legacy devices, and connect to other devices capable of Wi-Fi P2P
   connections.
    
-  
    Using Wi-Fi Direct for Service
+  
    Using Wi-Fi P2P for Service
       Discovery
    
   
    Learn how to discover services published by nearby devices without being
-  on the same network, using Wi-Fi Direct.
    
+  on the same network, using Wi-Fi P2P.
 
 
diff --git a/docs/html/training/connect-devices-wirelessly/nsd-wifi-direct.jd b/docs/html/training/connect-devices-wirelessly/nsd-wifi-direct.jd
index 5e276ded54918..8dc5fd96eb034 100644
--- a/docs/html/training/connect-devices-wirelessly/nsd-wifi-direct.jd
+++ b/docs/html/training/connect-devices-wirelessly/nsd-wifi-direct.jd
@@ -1,4 +1,4 @@
-page.title=Using Wi-Fi Direct for Service Discovery
+page.title=Using Wi-Fi P2P for Service Discovery
 parent.title=Connecting Devices Wirelessly
 parent.link=index.html
 
@@ -26,23 +26,23 @@ trainingnavtop=true
 
    The first lesson in this class, Using Network Service
   Discovery, showed you
 how to discover services that are connected to a local network. However, using
-Wi-Fi Direct&trad; Service Discovery allows you to discover the services of nearby devices directly,
-without being connected to a network.  You can also advertise the services
+Wi-Fi Peer-to-Peer (P2P) Service Discovery allows you to discover the services of nearby devices
+directly, without being connected to a network.  You can also advertise the services
 running on your device.  These capabilities help you communicate between apps,
 even when no local network or hotspot is available.
    
 
    While this set of APIs is similar in purpose to the Network Service Discovery
 APIs outlined in a previous lesson, implementing them in code is very different.
 This lesson shows you how to discover services available from other devices,
-using Wi-Fi Direct™. The lesson assumes that you're already familiar with the
-Wi-Fi Direct API.
    
+using Wi-Fi P2P. The lesson assumes that you're already familiar with the
+Wi-Fi P2P API.
    
 
 
 
    Set Up the Manifest
    
-
    In order to use Wi-Fi Direct, add the {@link
+
    In order to use Wi-Fi P2P, add the {@link
 android.Manifest.permission#CHANGE_WIFI_STATE}, {@link
 android.Manifest.permission#ACCESS_WIFI_STATE},
 and {@link android.Manifest.permission#INTERNET}
-permissions to your manifest.  Even though Wi-Fi Direct doesn't require an
+permissions to your manifest.  Even though Wi-Fi P2P doesn't require an
 Internet connection, it uses standard Java sockets, and using these in Android
 requires the requested permissions.
    
 
@@ -244,7 +244,7 @@ provided by the method hints at the problem.  Here are the possible error values
 and what they mean
    
 
    
   
     {@link android.net.wifi.p2p.WifiP2pManager#P2P_UNSUPPORTED}
    
-  
     Wi-Fi Direct isn't supported on the device running the app.
    
+  
     Wi-Fi P2P isn't supported on the device running the app.
    
   
     {@link android.net.wifi.p2p.WifiP2pManager#BUSY}
    
   
     The system is to busy to process the request.
    
   
     {@link android.net.wifi.p2p.WifiP2pManager#ERROR}
    
diff --git a/docs/html/training/connect-devices-wirelessly/wifi-direct.jd b/docs/html/training/connect-devices-wirelessly/wifi-direct.jd
index b8ed6641a700b..98435c681ad5b 100644
--- a/docs/html/training/connect-devices-wirelessly/wifi-direct.jd
+++ b/docs/html/training/connect-devices-wirelessly/wifi-direct.jd
@@ -1,12 +1,6 @@
-page.title=Connecting with Wi-Fi Direct
-parent.title=Connecting Devices Wirelessly
-parent.link=index.html
+page.title=Creating P2P Connections with Wi-Fi
 
 trainingnavtop=true
-previous.title=Using Network Service Discovery
-previous.link=nsd.html
-next.title=Service Discovery with Wi-Fi Direct
-next.link=nsd-wifi-direct.html
 
 @jd:body
 
@@ -21,25 +15,30 @@ next.link=nsd-wifi-direct.html
       
  • Fetch the List of Peers
    • 
       
  • Connect to a Peer
    • 
     
+    
    You should also read
    
+    
   
 
 
-
    The Wi-Fi Direct™ APIs allow applications to connect to nearby devices without
-needing to connect to a network or hotspot.  This allows your application to quickly
+
    The Wi-Fi peer-to-peer (P2P) APIs allow applications to connect to nearby devices without
+needing to connect to a network or hotspot (Android's Wi-Fi P2P framework complies with the Wi-Fi
+Alliance's Wi-Fi Direct™ certification program).  Wi-Fi P2P allows your application to quickly
 find and interact with nearby devices, at a range beyond the capabilities of Bluetooth.
 
    
 
    
-This lesson shows you how to find and connect to nearby devices using Wi-Fi Direct.
+This lesson shows you how to find and connect to nearby devices using Wi-Fi P2P.
 
    
 
    Set Up Application Permissions
    
-
    In order to use Wi-Fi Direct, add the {@link
+
    In order to use Wi-Fi P2P, add the {@link
 android.Manifest.permission#CHANGE_WIFI_STATE}, {@link
 android.Manifest.permission#ACCESS_WIFI_STATE},
 and {@link android.Manifest.permission#INTERNET}
-permissions to your manifest.   Wi-Fi Direct doesn't require an internet connection,
+permissions to your manifest.   Wi-Fi P2P doesn't require an internet connection,
 but it does use standard Java sockets, which require the {@link
 android.Manifest.permission#INTERNET} permission.
-So you need the following permissions to use Wi-Fi Direct.
    
+So you need the following permissions to use Wi-Fi P2P.
    
 
 
     <manifest xmlns:android="http://schemas.android.com/apk/res/android"
@@ -59,13 +58,13 @@ So you need the following permissions to use Wi-Fi Direct.
    
 
    
 
 
    Set Up a Broadcast Receiver and Peer-to-Peer Manager
    
-
    To use Wi-Fi Direct, you need to listen for broadcast intents that tell your
+
    To use Wi-Fi P2P, you need to listen for broadcast intents that tell your
 application when certain events have occurred.  In your application, instantiate
 an {@link
 android.content.IntentFilter} and set it to listen for the following:
    
 
    
   
    {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_STATE_CHANGED_ACTION}
    
-  
    Indicates whether Wi-Fi Peer-To-Peer (P2P) is enabled
    
+  
    Indicates whether Wi-Fi P2P is enabled
    
   
    {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_PEERS_CHANGED_ACTION}
    
   
    Indicates that the available peer list has changed.
    
   
    {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_CONNECTION_CHANGED_ACTION}
    
@@ -80,7 +79,7 @@ public void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.main);
 
-    //  Indicates a change in the Wi-Fi Peer-to-Peer status.
+    //  Indicates a change in the Wi-Fi P2P status.
     intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION);
 
     // Indicates a change in the list of available peers.
@@ -101,7 +100,7 @@ android.net.wifi.p2p.WifiP2pManager}, and call its {@link
 android.net.wifi.p2p.WifiP2pManager#initialize(Context, Looper, WifiP2pManager.ChannelListener) initialize()}
 method.  This method returns a {@link
 android.net.wifi.p2p.WifiP2pManager.Channel} object, which you'll use later to
-connect your app to the Wi-Fi Direct Framework.
    
+connect your app to the Wi-Fi P2P framework.
    
 
 
     @Override
@@ -126,7 +125,7 @@ method, add a condition to handle each P2P state change listed above.
    
     public void onReceive(Context context, Intent intent) {
         String action = intent.getAction();
         if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
-            // Determine if Wifi Direct mode is enabled or not, alert
+            // Determine if Wifi P2P mode is enabled or not, alert
             // the Activity.
             int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1);
             if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) {
@@ -177,7 +176,7 @@ The best place to do this is the {@link android.app.Activity#onResume()} and
 
 
 
    Initiate Peer Discovery
    
-
    To start searching for nearby devices with Wi-Fi Direct, call {@link
+
    To start searching for nearby devices with Wi-Fi P2P, call {@link
 android.net.wifi.p2p.WifiP2pManager#discoverPeers(WifiP2pManager.Channel,
 WifiP2pManager.ActionListener) discoverPeers()}.  This method takes the
 following arguments:
    
@@ -218,7 +217,7 @@ formed.
    
 
    Fetch the List of Peers
    
 
    Now write the code that fetches and processes the list of peers.  First
 implement the {@link android.net.wifi.p2p.WifiP2pManager.PeerListListener}
-interface, which provides information about the peers that Wi-Fi Direct has
+interface, which provides information about the peers that Wi-Fi P2P has
 detected.  The following code snippet illustrates this.
    
 
 
    diff --git a/docs/html/training/training_toc.cs b/docs/html/training/training_toc.cs
index c99fc96b0033b..d44d7d487b8e5 100644
--- a/docs/html/training/training_toc.cs
+++ b/docs/html/training/training_toc.cs
@@ -405,7 +405,7 @@ include the action bar on devices running Android 2.1 or higher."
           Connecting Devices Wirelessly
    {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_STATE_CHANGED_ACTION}Broadcast when Wi-Fi Direct is enabled or disabled on the device.Broadcast when Wi-Fi P2P is enabled or disabled on the device.
    {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_THIS_DEVICE_CHANGED_ACTION}