Connectivity resilience

What is Apple Multipeer Connectivity?

Multipeer Connectivity is Apple's framework for finding nearby Apple devices that run a compatible app and exchanging messages, streams and files with them, over Wi-Fi or peer-to-peer Wi-Fi, with no server. It works only between Apple devices, and Apple has deprecated it. Apple's technote TN3213 says Xcode 27 deprecates the whole framework and tells developers to move to the Network framework.

TL;DR

Multipeer Connectivity links up to 8 nearby Apple devices per session, only in the foreground, and an Android phone cannot join. Apple advises migrating to the Network framework, which TN3213 maps feature by feature to Bonjour, QUIC or TCP streams and TLS. For iPhone and Android users who must reach each other, neither framework is enough alone.

Learning objectives

After reading this article you will be able to:

  • Describe the discovery and session phases of Apple's Multipeer Connectivity
  • Identify Multipeer Connectivity's limits, including Apple-only support and 8 peers per session
  • Explain how Apple's TN3213 maps Multipeer features to the Network framework

Apple Multipeer Connectivity framework

Multipeer Connectivity is an Apple framework that lets an app discover services offered by nearby devices and communicate with them using messages, streams and resources such as files. Apple introduced it in iOS 7, and its documentation lists iOS, iPadOS, Mac Catalyst, macOS, tvOS and visionOS. There is no Android version. What is MultipeerConnectivity? has the glossary definition.

The app does not pick the radio. Apple’s framework page says that on iOS it uses infrastructure Wi-Fi networks, peer-to-peer Wi-Fi and Bluetooth personal area networks underneath, though Apple’s support engineers now say it no longer uses Bluetooth; on macOS and tvOS it uses infrastructure Wi-Fi, peer-to-peer Wi-Fi and Ethernet. Because it uses the local network, an app must supply a NSLocalNetworkUsageDescription string and declare the Bonjour services it browses under NSBonjourServices.

Multipeer Connectivity discovery and sessions

Apple describes two phases: in discovery, one app advertises a named service type and another browses for it, and in the session phase, invited peers that accept communicate directly.

Discovery. One app runs an advertiser (MCNearbyServiceAdvertiser, or MCAdvertiserAssistant with a standard accept screen) to say it is willing to join sessions of a named service type. Another runs a browser (MCNearbyServiceBrowser, or MCBrowserViewController with a standard picker) to find it. Each app instance on a device is identified to its neighbours by an MCPeerID. During this phase apps know little about each other: only the small discoveryInfo dictionary a peer advertises and any context sent with an invitation.

Session. The browsing app invites the chosen peers into an MCSession. The other app can accept or decline, and can ask its user first. Once a peer accepts, the browser connects to the advertiser and the two can communicate directly; the framework reports peers joining and leaving through delegate callbacks.

A session supports up to 8 peers, including the local one. Inside it, an app has three ways to send:

  • Data with send(_:toPeers:with:), in reliable mode, where delivery is guaranteed, or unreliable mode for data that is useless if it arrives late.
  • Resources with sendResource(at:withName:toPeer:withCompletionHandler:), which sends a file or URL and returns a progress object the app can use to cancel.
  • Streams with startStream(withName:toPeer:), a byte stream the app manages itself.

Security is a session setting: MCEncryptionPreference is none, optional or required. TN3213 says the required model needs the app to supply a digital identity, and that optional security adds complexity without any actual security benefit.

Multipeer Connectivity limits

Multipeer Connectivity works only between Apple devices, only while the app is in the foreground, and with up to 8 peers per session, and its peer-to-peer Wi-Fi is not Android’s Wi-Fi Direct.

  • Apple only. An Android phone cannot join a session. Multipeer Connectivity alternatives that work with Android covers what to use instead.
  • Foreground only. If the app moves to the background, the framework stops advertising and browsing and disconnects open sessions. When the app returns, advertising and browsing resume, but the app must set up the closed sessions again. Bluetooth has its own background rules on iOS, covered in Can a BLE app run in the background on iOS?.
  • Small groups. The 8-peer limit applies per session, and members talk to each other directly. A larger group needs a different design, such as a mesh that relays through other devices.
  • Not Wi-Fi Direct. TN3213 separates Apple peer-to-peer Wi-Fi from industry-standard peer-to-peer Wi-Fi, which Apple supports through Wi-Fi Aware. So when a framework or library says it uses peer-to-peer Wi-Fi on an iPhone, that does not mean Android’s Wi-Fi Direct.

Multipeer Connectivity without Bluetooth

Multipeer Connectivity does not use Bluetooth at all on current Apple systems. Apple’s framework page still lists Bluetooth personal area networks among the links it uses on iOS, but in December 2025 an engineer in Apple’s Developer Technical Support wrote on the Apple Developer Forums that “Multipeer Connectivity hasn’t worked over Bluetooth for 10-ish years. On modern systems its peer-to-peer support is based entirely on peer-to-peer Wi-Fi.” The same reply says Apple first disabled the opt-in for peer-to-peer Bluetooth and later removed the implementation, and it advises relying on peer-to-peer Wi-Fi or Wi-Fi Aware instead.

So two iPhones with Wi-Fi turned off will not find each other through Multipeer Connectivity, even with Bluetooth on. An app that needs Bluetooth between phones has to use Core Bluetooth directly. The Offline Protocol mesh SDK moved its iPhone peer stream from Multipeer Connectivity to the Network framework in 0.28.0, as its architecture decision record 0027 explains, and reaches nearby phones over Bluetooth LE through a separate transport.

Multipeer Connectivity deprecation and replacement

Apple’s framework page now says Multipeer Connectivity is deprecated and that code using it should move to the Network framework. TN3213 says Xcode 27 deprecates the entire framework, and the API reference marks classes such as MCSession deprecated in iOS 27 and the aligned releases, with the message “Use Network Framework instead”. The technote’s advice to developers with Multipeer code is to plan the migration.

TN3213 maps each part of the framework to a Network framework equivalent, using the API introduced in iOS 26 (NetworkConnection, NetworkListener and NetworkBrowser):

Multipeer ConnectivityApproach in TN3213
Advertiser and browser for a service typeA listener that advertises a Bonjour service, and a browser for that service type
Standard picker and invitation screensNo direct equivalent; DeviceDiscoveryUI to pair for Wi-Fi Aware, or the app’s own interface
Metadata a peer advertises during discoveryBonjour TXT records
Reliable send modeA reliable stream, with QUIC as the suggested default, or TCP or WebSocket
Unreliable send modeQUIC datagrams or a UDP flow
Required encryptionTLS with a local identity, mutual authentication and a custom check of the peer’s certificate

Two details in the technote matter for offline apps. First, the Network framework does not enable peer-to-peer Wi-Fi by default; an app opts in, and Apple warns that doing so can reduce network performance for that app and others on the device, suggesting Wi-Fi Aware instead. Second, Wi-Fi Aware with QUIC is not supported before iOS 27. Wi-Fi Aware itself needs iOS 26 or later, and pairing through Apple’s interfaces, before two devices can connect.

For an app that runs only on Apple devices, the Network framework is now the documented path. For an app whose iPhone and Android users must reach each other, neither Multipeer Connectivity nor its replacement is enough on its own, and Can an iPhone and an Android phone connect directly without internet? goes through the links the two platforms share.

Frequently asked questions

Is Multipeer Connectivity deprecated?

Yes. Apple's framework page marks it deprecated, its API reference lists the classes as deprecated in iOS 27 and the aligned releases, and TN3213 explains how to move to the Network framework.

Can an Android phone join a Multipeer Connectivity session?

No. The framework is documented for Apple platforms only. Apps that need iPhones and Android phones to talk directly use a link both platforms open to apps, such as Bluetooth LE, with the same protocol on each side.

How many peers can a Multipeer Connectivity session have?

Up to 8, including the local one, and members talk to each other directly. A larger group needs a different design, such as a mesh that relays through other devices.

Does Multipeer Connectivity work in the background?

No. If the app moves to the background, the framework stops advertising and browsing and disconnects open sessions. When the app returns, advertising and browsing resume, but the app must set up the closed sessions again.

Is Multipeer Connectivity encrypted?

Security is a session setting, and MCEncryptionPreference is none, optional or required. TN3213 says the required model needs the app to supply a digital identity, and that optional security adds complexity without any actual security benefit.

What replaces Multipeer's send modes in the Network framework?

TN3213 maps reliable send mode to a reliable stream, with QUIC as the suggested default, or TCP or WebSocket. Unreliable send mode maps to QUIC datagrams or a UDP flow.

Sources

Build it with Offline Protocol

Since version 0.28.0 the Offline Protocol mesh SDK runs its iPhone peer stream on the Network framework, over the local network or AWDL, instead of Multipeer Connectivity. Since 0.29.0 an Android phone joins that path on a shared Wi-Fi network, so an iPhone and an Android phone on one network open a peer stream to each other. The platforms page lists the transports it uses on iOS and Android; the phone quickstart uses Bluetooth LE, the path an iPhone and an Android phone share with no network at all.

Read platforms and transports