このページは Cloud Translation API によって翻訳されました。

Wi-Fi Direct で P2P 接続を作成する

Wi-Fi Direct（ピアツーピア、P2P とも呼ばれます）を使用すると、アプリは付近の Bluetooth の能力を超えた幅広いデバイスに対応できます。

Wi-Fi Direct（P2P）API を使用すると、アプリが付近のデバイスに接続する際、ネットワークやアクセスポイントへの接続が必要です。アプリが安全な近距離ネットワークの一部となるように設計されている場合、Wi-Fi は従来の Wi-Fi アドホックよりも Direct の方が適している次の理由があります。

Wi-Fi Direct は WPA2 暗号化をサポートします（一部のアドホックネットワークは、 WEP 暗号化。）
デバイスは、提供するサービスをブロードキャストできるため、デバイスが適切なピアを簡単に検出できるようになります。
どのデバイスをネットワークのグループオーナーにするかを決定するときは、 Wi-Fi Direct は各デバイスの電源管理、UI、サービスを検証この情報を使用してサーバーを最も効果的に管理できるようになります。
Android は Wi-Fi アドホックモードをサポートしていません。

このレッスンでは、Wi-Fi P2P を使用して付近のデバイスを見つけて接続する方法について説明します。

アプリの権限をセットアップする

Wi-Fi Direct を使用するには、 ACCESS_FINE_LOCATION, CHANGE_WIFI_STATE, ACCESS_WIFI_STATE、および INTERNET 権限をマニフェストに追加する。 Android 13（API レベル 33）以降をターゲットとするアプリの場合は、 NEARBY_WIFI_DEVICES マニフェストに追加します。Wi-Fi Direct ではインターネット接続は必要ありませんが、標準の Java が使用されます。ソケット。これには INTERNET が必要です。付与します。そのため、Wi-Fi Direct を使用するには次の権限が必要です。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.android.nsdchat"
    ...
    <!-- If your app targets Android 13 (API level 33)
         or higher, you must declare the NEARBY_WIFI_DEVICES permission. -->
        <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
        <!-- If your app derives location information from Wi-Fi APIs,
             don't include the "usesPermissionFlags" attribute. -->
        android:usesPermissionFlags="neverForLocation" />
        
    <uses-permission
        android:required="true"
        android:name="android.permission.ACCESS_FINE_LOCATION"
        <!-- If any feature in your app relies on precise location information,
             don't include the "maxSdkVersion" attribute. -->
        android:maxSdkVersion="32" />
    <uses-permission
        android:required="true"
        android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission
        android:required="true"
        android:name="android.permission.CHANGE_WIFI_STATE"/>
    <uses-permission
        android:required="true"
        android:name="android.permission.INTERNET"/>
    ...

以下の API を使用するには、上記の権限に加えて、位置情報モードを有効にする必要があります。

ブロードキャストレシーバとピアツーピアマネージャーをセットアップする

Wi-Fi Direct を使用するには、アプリケーションを自動的に起動できます。アプリで、Cloud Storage バケットを IntentFilter を追加して、以下をリッスンするように設定します。

WIFI_P2P_STATE_CHANGED_ACTION: Wi-Fi Direct が有効かどうかを示します。
WIFI_P2P_PEERS_CHANGED_ACTION: 利用可能なピアリストが変更されたことを示します。
WIFI_P2P_CONNECTION_CHANGED_ACTION: Wi-Fi Direct 接続の状態が変化したことを示します。まずは Android 10 では、これは固定ではありません。アプリがこれらのメッセージの受信に依存している場合がスティッキーであったため登録時にブロードキャストした場合は、適切な get を使用します。メソッドを使い、代わりに情報を取得してください。
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION: このデバイスの設定の詳細が変更されたことを示します。まずは Android 10 では、これは固定ではありません。アプリがこれらのメッセージの受信に依存している場合がスティッキーであったため登録時にブロードキャストした場合は、適切な get を使用します。メソッドを使い、代わりに情報を取得してください。

Kotlin

private val intentFilter = IntentFilter()
...
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

    // Indicates a change in the Wi-Fi Direct status.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION)

    // Indicates a change in the list of available peers.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION)

    // Indicates the state of Wi-Fi Direct connectivity has changed.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION)

    // Indicates this device's details have changed.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION)
    ...
}

Java

private final IntentFilter intentFilter = new IntentFilter();
...
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    // Indicates a change in the Wi-Fi Direct status.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION);

    // Indicates a change in the list of available peers.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION);

    // Indicates the state of Wi-Fi Direct connectivity has changed.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION);

    // Indicates this device's details have changed.
    intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION);
    ...
}

onCreate() メソッドの最後で、WifiP2pManager のインスタンスを取得し、その initialize() を呼び出します。メソッドを呼び出します。このメソッドは WifiP2pManager.Channel オブジェクトを返します。このオブジェクトは、後で次の場合に使用し、アプリを Wi-Fi Direct フレームワークに接続します。

Kotlin

private lateinit var channel: WifiP2pManager.Channel
private lateinit var manager: WifiP2pManager

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    manager = getSystemService(Context.WIFI_P2P_SERVICE) as WifiP2pManager
    channel = manager.initialize(this, mainLooper, null)
}

Java

Channel channel;
WifiP2pManager manager;

@Override
public void onCreate(Bundle savedInstanceState) {
    ...
    manager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE);
    channel = manager.initialize(this, getMainLooper(), null);
}

次に、変更をリッスンする BroadcastReceiver クラスを新規作成します。システムの Wi-Fi 状態に戻します。onReceive() メソッドに、上記の各状態変化を処理する条件を追加します。

Kotlin

override fun onReceive(context: Context, intent: Intent) {
    when(intent.action) {
        WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> {
            // Determine if Wi-Fi Direct mode is enabled or not, alert
            // the Activity.
            val state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1)
            activity.isWifiP2pEnabled = state == WifiP2pManager.WIFI_P2P_STATE_ENABLED
        }
        WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> {

            // The peer list has changed! We should probably do something about
            // that.

        }
        WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION -> {

            // Connection state changed! We should probably do something about
            // that.

        }
        WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION -> {
            (activity.supportFragmentManager.findFragmentById(R.id.frag_list) as DeviceListFragment)
                    .apply {
                        updateThisDevice(
                                intent.getParcelableExtra(
                                        WifiP2pManager.EXTRA_WIFI_P2P_DEVICE) as WifiP2pDevice
                        )
                    }
        }
    }
}

Java

@Override
public void onReceive(Context context, Intent intent) {
    String action = intent.getAction();
    if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
        // Determine if Wi-Fi Direct mode is enabled or not, alert
        // the Activity.
        int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1);
        if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) {
            activity.setIsWifiP2pEnabled(true);
        } else {
            activity.setIsWifiP2pEnabled(false);
        }
    } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) {

        // The peer list has changed! We should probably do something about
        // that.

    } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) {

        // Connection state changed! We should probably do something about
        // that.

    } else if (WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION.equals(action)) {
        DeviceListFragment fragment = (DeviceListFragment) activity.getFragmentManager()
                .findFragmentById(R.id.frag_list);
        fragment.updateThisDevice((WifiP2pDevice) intent.getParcelableExtra(
                WifiP2pManager.EXTRA_WIFI_P2P_DEVICE));

    }
}

最後に、インテントフィルタとブロードキャストレシーバを登録するコードを追加します。メインアクティビティが有効になっていて、そのアクティビティが一時停止したときにその登録を解除すること。そのためには、onResume() と onPause() メソッド。

Kotlin

/** register the BroadcastReceiver with the intent values to be matched  */
public override fun onResume() {
    super.onResume()
    receiver = WiFiDirectBroadcastReceiver(manager, channel, this)
    registerReceiver(receiver, intentFilter)
}

public override fun onPause() {
    super.onPause()
    unregisterReceiver(receiver)
}

Java

/** register the BroadcastReceiver with the intent values to be matched */
@Override
public void onResume() {
    super.onResume();
    receiver = new WiFiDirectBroadcastReceiver(manager, channel, this);
    registerReceiver(receiver, intentFilter);
}

@Override
public void onPause() {
    super.onPause();
    unregisterReceiver(receiver);
}

ピアの検出を開始する

Wi-Fi P2P を使用して近くのデバイスの検索を開始するには、discoverPeers() を呼び出します。このメソッドは、次の引数を使用します。

WifiP2pManager.Channel をピアツーピアの mManager を初期化したときに返される
メソッドを含む WifiP2pManager.ActionListener の実装検出の成功時と失敗時にシステムが呼び出します。

Kotlin

manager.discoverPeers(channel, object : WifiP2pManager.ActionListener {

    override fun onSuccess() {
        // Code for when the discovery initiation is successful goes here.
        // No services have actually been discovered yet, so this method
        // can often be left blank. Code for peer discovery goes in the
        // onReceive method, detailed below.
    }

    override fun onFailure(reasonCode: Int) {
        // Code for when the discovery initiation fails goes here.
        // Alert the user that something went wrong.
    }
})

Java

manager.discoverPeers(channel, new WifiP2pManager.ActionListener() {

    @Override
    public void onSuccess() {
        // Code for when the discovery initiation is successful goes here.
        // No services have actually been discovered yet, so this method
        // can often be left blank. Code for peer discovery goes in the
        // onReceive method, detailed below.
    }

    @Override
    public void onFailure(int reasonCode) {
        // Code for when the discovery initiation fails goes here.
        // Alert the user that something went wrong.
    }
});

このコードはピア検出を開始するのみであることにご注意ください。「 discoverPeers() メソッドが検出プロセスを開始してから、すぐに返されます。ピア検出プロセスが指定されたアクションリスナー内のメソッドを呼び出して正常に開始されたことを確認します。また、接続が開始されるか P2P グループが開始されるまで、検出はアクティブのままです。あります。

ピアのリストを取得する

次に、ピアのリストを取得して処理するコードを作成します。最初 WifiP2pManager.PeerListListener を実装するインターフェース（Wi-Fi Direct が接続しているピアに関する情報）検出されます。また、この情報により、アプリはピアが参加するタイミングや、離れます次のコードスニペットは、これらの操作を示しています。類似アプリ:

Kotlin

private val peers = mutableListOf<WifiP2pDevice>()
...

private val peerListListener = WifiP2pManager.PeerListListener { peerList ->
    val refreshedPeers = peerList.deviceList
    if (refreshedPeers != peers) {
        peers.clear()
        peers.addAll(refreshedPeers)

        // If an AdapterView is backed by this data, notify it
        // of the change. For instance, if you have a ListView of
        // available peers, trigger an update.
        (listAdapter as WiFiPeerListAdapter).notifyDataSetChanged()

        // Perform any other updates needed based on the new list of
        // peers connected to the Wi-Fi P2P network.
    }

    if (peers.isEmpty()) {
        Log.d(TAG, "No devices found")
        return@PeerListListener
    }
}

Java

private List<WifiP2pDevice> peers = new ArrayList<WifiP2pDevice>();
...

private PeerListListener peerListListener = new PeerListListener() {
    @Override
    public void onPeersAvailable(WifiP2pDeviceList peerList) {

        List<WifiP2pDevice> refreshedPeers = peerList.getDeviceList();
        if (!refreshedPeers.equals(peers)) {
            peers.clear();
            peers.addAll(refreshedPeers);

            // If an AdapterView is backed by this data, notify it
            // of the change. For instance, if you have a ListView of
            // available peers, trigger an update.
            ((WiFiPeerListAdapter) getListAdapter()).notifyDataSetChanged();

            // Perform any other updates needed based on the new list of
            // peers connected to the Wi-Fi P2P network.
        }

        if (peers.size() == 0) {
            Log.d(WiFiDirectActivity.TAG, "No devices found");
            return;
        }
    }
}

次に、ブロードキャストレシーバの onReceive() を変更します。メソッド: WIFI_P2P_PEERS_CHANGED_ACTION アクションを含むインテントを受信したときに requestPeers() を呼び出すマイページなんらかの方法でこのリスナーをレシーバに渡す必要があります。一つの方法は、引数としてブロードキャストレシーバのコンストラクタに渡す必要があります。

Kotlin

fun onReceive(context: Context, intent: Intent) {
    when (intent.action) {
        ...
        WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> {

            // Request available peers from the wifi p2p manager. This is an
            // asynchronous call and the calling activity is notified with a
            // callback on PeerListListener.onPeersAvailable()
            mManager?.requestPeers(channel, peerListListener)
            Log.d(TAG, "P2P peers changed")


        }
        ...
    }
}

Java

public void onReceive(Context context, Intent intent) {
    ...
    else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) {

        // Request available peers from the wifi p2p manager. This is an
        // asynchronous call and the calling activity is notified with a
        // callback on PeerListListener.onPeersAvailable()
        if (mManager != null) {
            mManager.requestPeers(channel, peerListListener);
        }
        Log.d(WiFiDirectActivity.TAG, "P2P peers changed");
    }...
}

では、WIFI_P2P_PEERS_CHANGED_ACTION アクションインテントを含むインテントを見てみましょう。更新されたピアリストに対するリクエストをトリガーします。

ピアに接続する

ピアに接続するには、新しい WifiP2pConfig オブジェクトを作成し、 WifiP2pDevice は、使用するデバイスを表します。接続します次に、connect() を呼び出します。メソッドを呼び出します。

Kotlin

override fun connect() {
    // Picking the first device found on the network.
    val device = peers[0]

    val config = WifiP2pConfig().apply {
        deviceAddress = device.deviceAddress
        wps.setup = WpsInfo.PBC
    }

    manager.connect(channel, config, object : WifiP2pManager.ActionListener {

        override fun onSuccess() {
            // WiFiDirectBroadcastReceiver notifies us. Ignore for now.
        }

        override fun onFailure(reason: Int) {
            Toast.makeText(
                    this@WiFiDirectActivity,
                    "Connect failed. Retry.",
                    Toast.LENGTH_SHORT
            ).show()
        }
    })
}

Java

@Override
public void connect() {
    // Picking the first device found on the network.
    WifiP2pDevice device = peers.get(0);

    WifiP2pConfig config = new WifiP2pConfig();
    config.deviceAddress = device.deviceAddress;
    config.wps.setup = WpsInfo.PBC;

    manager.connect(channel, config, new ActionListener() {

        @Override
        public void onSuccess() {
            // WiFiDirectBroadcastReceiver notifies us. Ignore for now.
        }

        @Override
        public void onFailure(int reason) {
            Toast.makeText(WiFiDirectActivity.this, "Connect failed. Retry.",
                    Toast.LENGTH_SHORT).show();
        }
    });
}

グループ内の各デバイスが Wi-Fi Direct に対応している場合、接続時にグループのパスワードを明示的に要求します。デバイスの利用を許可するには Wi-Fi Direct に対応していないデバイスでもグループに参加するには、このパスワードを取得するには、次の関数を呼び出して requestGroupInfo()、次のコードスニペットをご覧ください。

Kotlin

manager.requestGroupInfo(channel) { group ->
    val groupPassword = group.passphrase
}

Java

manager.requestGroupInfo(channel, new GroupInfoListener() {
  @Override
  public void onGroupInfoAvailable(WifiP2pGroup group) {
      String groupPassword = group.getPassphrase();
  }
});

なお、WifiP2pManager.ActionListener は connect() メソッドは、開始成功するか失敗するかを決定します。接続状態の変化をリッスンするには、次のように実装します。 WifiP2pManager.ConnectionInfoListener インターフェース。その onConnectionInfoAvailable() コールバックは、自動的に適用されます。複数のデバイスを 1 つのデバイス（3 人以上のプレーヤーが参加するゲームやチャットアプリなど）、1 つのデバイス「グループオーナー」になります。特定のデバイスをネットワークのグループオーナーに連絡するには、 [Create a Group] セクション。

Kotlin

private val connectionListener = WifiP2pManager.ConnectionInfoListener { info ->

    // String from WifiP2pInfo struct
    val groupOwnerAddress: String = info.groupOwnerAddress.hostAddress

    // After the group negotiation, we can determine the group owner
    // (server).
    if (info.groupFormed && info.isGroupOwner) {
        // Do whatever tasks are specific to the group owner.
        // One common case is creating a group owner thread and accepting
        // incoming connections.
    } else if (info.groupFormed) {
        // The other device acts as the peer (client). In this case,
        // you'll want to create a peer thread that connects
        // to the group owner.
    }
}

Java

@Override
public void onConnectionInfoAvailable(final WifiP2pInfo info) {

    // String from WifiP2pInfo struct
    String groupOwnerAddress = info.groupOwnerAddress.getHostAddress();

    // After the group negotiation, we can determine the group owner
    // (server).
    if (info.groupFormed && info.isGroupOwner) {
        // Do whatever tasks are specific to the group owner.
        // One common case is creating a group owner thread and accepting
        // incoming connections.
    } else if (info.groupFormed) {
        // The other device acts as the peer (client). In this case,
        // you'll want to create a peer thread that connects
        // to the group owner.
    }
}

ブロードキャストレシーバの onReceive() メソッドに戻り、セクションを変更します。 WIFI_P2P_CONNECTION_CHANGED_ACTION インテントをリッスンします。このインテントが受信されたら、requestConnectionInfo() を呼び出します。これは非同期呼び出しであり接続情報リスナーが結果を受け取ります。パラメータを指定します。

Kotlin

when (intent.action) {
    ...
    WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION -> {

        // Connection state changed! We should probably do something about
        // that.

        mManager?.let { manager ->

            val networkInfo: NetworkInfo? = intent
                    .getParcelableExtra(WifiP2pManager.EXTRA_NETWORK_INFO) as NetworkInfo

            if (networkInfo?.isConnected == true) {

                // We are connected with the other device, request connection
                // info to find group owner IP

                manager.requestConnectionInfo(channel, connectionListener)
            }
        }
    }
    ...
}

Java

    ...
    } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) {

        if (manager == null) {
            return;
        }

        NetworkInfo networkInfo = (NetworkInfo) intent
                .getParcelableExtra(WifiP2pManager.EXTRA_NETWORK_INFO);

        if (networkInfo.isConnected()) {

            // We are connected with the other device, request connection
            // info to find group owner IP

            manager.requestConnectionInfo(channel, connectionListener);
        }
        ...

グループを作成する

アプリを実行しているデバイスを、以前のデバイス、すなわち Google Cloud に対応していない Wi-Fi Direct の場合は、 [Connect to a Peer] セクション（新しいプラットフォームを作成する場合を除きます） WifiP2pManager.ActionListener connect() ではなく createGroup() を使用します。モジュール内でのコールバック処理は、 WifiP2pManager.ActionListener 次のコードスニペットに示されているとおり、これは同じです。

Kotlin

manager.createGroup(channel, object : WifiP2pManager.ActionListener {
    override fun onSuccess() {
        // Device is ready to accept incoming connections from peers.
    }

    override fun onFailure(reason: Int) {
        Toast.makeText(
                this@WiFiDirectActivity,
                "P2P group creation failed. Retry.",
                Toast.LENGTH_SHORT
        ).show()
    }
})

Java

manager.createGroup(channel, new WifiP2pManager.ActionListener() {
    @Override
    public void onSuccess() {
        // Device is ready to accept incoming connections from peers.
    }

    @Override
    public void onFailure(int reason) {
        Toast.makeText(WiFiDirectActivity.this, "P2P group creation failed. Retry.",
                Toast.LENGTH_SHORT).show();
    }
});

注: ネットワーク内のすべてのデバイスが Wi-Fi に対応している場合直接。各デバイスで connect() メソッドを使用できます。これは、メソッドがグループを作成し、グループオーナーを自動的に選択します。

グループを作成したら、 requestGroupInfo(): 次のピアの詳細を取得します。デバイス名や接続ステータスなどが表示されます。

Wi-Fi Direct で P2P 接続を作成する

アプリの権限をセットアップする

ブロードキャスト レシーバとピアツーピア マネージャーをセットアップする

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

ピアの検出を開始する

Kotlin

Java

ピアのリストを取得する

Kotlin

Java

Kotlin

Java

ピアに接続する

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

グループを作成する

Kotlin

Java

ブロードキャストレシーバとピアツーピアマネージャーをセットアップする