تبلیغ و کاوش

راه‌اندازی «مدیر اتصال»

مدیر اتصال همه رویدادهای اتصال را مدیریت می‌کند و میانای انتقال داده بین دستگاه‌ها است. این ویژگی برای تبلیغات و اکتشاف الزامی است.

ابتدا باید شناسه سرویسی انتخاب شود که به‌طور منحصربه‌فرد برنامه‌تان را شناسایی کند. به‌عنوان یک روش بهینه، از نام بسته برنامه‌تان استفاده کنید (برای مثال، com.example.app).

سپس، استراتژی‌ای برای مورد استفاده‌تان انتخاب کنید. استراتژی‌ای که انتخاب می‌کنید توپولوژی اتصال را برای برنامه‌تان تعیین می‌کند (.cluster، .star، .pointToPoint).

مدیر اتصال را مقداردهی اولیه کنید و روش‌های نماینده آن را پیاده‌سازی کنید:

Swift

import NearbyConnections

class Example {
  let connectionManager: ConnectionManager

  init() {
    connectionManager = ConnectionManager(serviceID: "com.example.app", strategy: .cluster)
    connectionManager.delegate = self
  }
}

extension Example: ConnectionManagerDelegate {
  func connectionManager(
    _ connectionManager: ConnectionManager, didReceive verificationCode: String,
    from endpointID: EndpointID, verificationHandler: @escaping (Bool) -> Void) {
    // Optionally show the user the verification code. Your app should call this handler
    // with a value of `true` if the nearby endpoint should be trusted, or `false`
    // otherwise.
    verificationHandler(true)
  }

  func connectionManager(
    _ connectionManager: ConnectionManager, didReceive data: Data,
    withID payloadID: PayloadID, from endpointID: EndpointID) {
    // A simple byte payload has been received. This will always include the full data.
  }

  func connectionManager(
    _ connectionManager: ConnectionManager, didReceive stream: InputStream,
    withID payloadID: PayloadID, from endpointID: EndpointID,
    cancellationToken token: CancellationToken) {
    // We have received a readable stream.
  }

  func connectionManager(
    _ connectionManager: ConnectionManager,
    didStartReceivingResourceWithID payloadID: PayloadID,
    from endpointID: EndpointID, at localURL: URL,
    withName name: String, cancellationToken token: CancellationToken) {
    // We have started receiving a file. We will receive a separate transfer update
    // event when complete.
  }

  func connectionManager(
    _ connectionManager: ConnectionManager,
    didReceiveTransferUpdate update: TransferUpdate,
    from endpointID: EndpointID, forPayload payloadID: PayloadID) {
    // A success, failure, cancelation or progress update.
  }

  func connectionManager(
    _ connectionManager: ConnectionManager, didChangeTo state: ConnectionState,
    for endpointID: EndpointID) {
    switch state {
    case .connecting:
      // A connection to the remote endpoint is currently being established.
    case .connected:
      // We're connected! Can now start sending and receiving data.
    case .disconnected:
      // We've been disconnected from this endpoint. No more data can be sent or received.
    case .rejected:
      // The connection was rejected by one or both sides.
    }
  }
}

شروع تبلیغات

برای شروع تبلیغ، تبلیغ‌کننده را مقداردهی اولیه کنید، روش‌های نماینده آن را پیاده‌سازی کنید، و با startAdvertising(using:) تماس بگیرید.

Swift

import NearbyConnections

class Example {
  let connectionManager: ConnectionManager
  let advertiser: Advertiser

  init() {
    connectionManager = ConnectionManager(serviceID: "com.example.app", strategy: .cluster)
    connectionManager.delegate = self

    advertiser = Advertiser(connectionManager: connectionManager)
    advertiser.delegate = self

    // The endpoint info can be used to provide arbitrary information to the
    // discovering device (e.g. device name or type).
    advertiser.startAdvertising(using: "My Device".data(using: .utf8)!)
  }
}

extension Example: AdvertiserDelegate {
  func advertiser(
    _ advertiser: Advertiser, didReceiveConnectionRequestFrom endpointID: EndpointID,
    with context: Data, connectionRequestHandler: @escaping (Bool) -> Void) {
    // Accept or reject any incoming connection requests. The connection will still need to
    // be verified in the connection manager delegate.
    connectionRequestHandler(true)
  }
}

شروع کاوش

برای شروع کاوش، کاوشگر را مقداردهی اولیه کنید، روش‌های نماینده آن را پیاده‌سازی کنید، و با startDiscovery() تماس بگیرید.

Swift

import NearbyConnections

class Example {
  let connectionManager: ConnectionManager
  let discoverer: Discoverer

  init() {
    connectionManager = ConnectionManager(serviceID: "com.example.app", strategy: .cluster)
    connectionManager.delegate = self

    discoverer = Discoverer(connectionManager: connectionManager)
    discoverer.delegate = self

    discoverer.startDiscovery()
  }
}

extension Example: DiscovererDelegate {
  func discoverer(
    _ discoverer: Discoverer, didFind endpointID: EndpointID, with context: Data) {
    // An endpoint was found.
  }

  func discoverer(_ discoverer: Discoverer, didLose endpointID: EndpointID) {
    // A previously discovered endpoint has gone away.
  }
}

توجه: پس‌از فراخوانی stopDiscovery()، کاشف همچنان می‌تواند درخواست اتصال به آگهی‌دهندگانی را که کشف شده‌اند بدهد؛ اما کاشف تا زمانی که دوباره کاوش را شروع نکند، آگهی‌دهنده جدیدی را کشف نخواهد کرد.

احتیاط: ازآنجایی‌که اکثر اشکال کاوش مستلزم عملیات رادیویی سنگین است که احتمال قطع شدن اتصالات برقرارشده را افزایش می‌دهد، یک الگوی بسیار رایج این است که پس‌از پیدا کردن همه همتایانی که می‌خواهید به آن‌ها متصل شوید و با آن‌ها تبادل داده کنید، stopDiscovery() را فراخوانی کنید.