Guides and Sample Code

Developer

Playground Book Format Reference

On This Page

PlaygroundBluetoothCentralManager

A streamlined interface for connecting the central manager for the current playground page to nearby Bluetooth peripherals.
現在のプレイグラウンドページのためのセントラルマネージャを近くのBluetooth周辺機器に接続するためのストリームラインインターフェイス。

Initializers
イニシャライザ

init(services:queue:)

Creates a central manager that supports communicating with Bluetooth peripherals.
セントラルマネージャを作成します、それはBluetooth周辺機器との接続をサポートするものです。

Declaration
宣言

  • init(services: [CBUUID]?, queue: DispatchQueue = .main)

Parameters
パラメータ

services

An array of service identifiers that the central manager scans for. If nil, all peripherals in range are eligible for connection attempts.
セントラルマネージャが走査する幾つかのサービス識別子の配列。nilならば、範囲内のすべての周辺機器が接続を試みる対象となります。

queue

The dispatch queue used to dispatch events to the central manager’s delegate.
セントラルマネージャの持つデリゲートにイベントを発送するために使われるディスパッチキュー。

Instance Properties
インスタンスプロパティ

connectedPeripherals

An array of the peripherals currently connected to the central manager.
現在セントラルマネージャに接続される周辺機器の配列。

Declaration
宣言

  1. var connectedPeripherals: [CBPeripheral]

delegate

A delegate that can receive messages from the central manager by adopting the PlaygroundBluetoothCentralManagerDelegate protocol.
あるデリゲート、それはセントラルマネージャからメッセージを受け取ることがPlaygroundBluetoothCentralManagerDelegateプロトコルの採用によって可能です。

Declaration
宣言

  1. weak var delegate: PlaygroundBluetoothCentralManagerDelegate?

scanning

A Boolean value that determines whether the central manager is scanning for peripherals.
あるブール値、それはセントラルマネージャが周辺機器を走査しているかどうかを明らかにします。

Declaration
宣言

  1. var scanning: Bool = false

Discussion
解説

Set this property to true to start scanning for peripherals. Upon discovering a peripheral, the central manager calls the delegate’s centralManager(_:didDiscover:withAdvertisementData:rssi:) method.
このプロパティをtrueに設定することによって、周辺機器の走査が始まります。周辺機器の発見の場合に、セントラルマネージャはデリゲートの持つcentralManager(_:didDiscover:withAdvertisementData:rssi:)メソッドを呼び出します。

state

The current state of the central manager.
セントラルマネージャの現在の状態。

Declaration
宣言

  1. var state: CBManagerState

Instance Methods
インスタンスメソッド

connect(to:timeout:callback:)

Attempts to connect the central manager to the specified peripheral.
セントラルマネージャを指定の周辺機器と接続することを試みます。

Declaration
宣言

  • func connect(to peripheral: CBPeripheral, timeout: TimeInterval? = nil, callback: ((CBPeripheral, Error?) -> Void)? = nil)

Parameters
パラメータ

peripheral

The peripheral to attempt to connect to.
この周辺機器に接続を試みます。

timeout

The amount of time, in seconds, before the connection attempt is aborted. If the timeout value is nil, the attempt won’t time out. To cancel a connection attempt, call the disconnect(from:) method.
接続の試みが中断される前の時間、秒数で。timeout値がnilならば、その試みは中断しません。ある接続の試みをキャンセルするには、disconnect(from:)メソッドを呼び出してください。

callback

A function that’s called when the connection attempt succeeds or fails.
その接続の試みが成功または失敗する時に呼び出される関数。

connect(toPeripheralWithUUID:timeout:callback:)

Attempts to connect the central manager to a peripheral with the specified unique identifier.
セントラルマネージャを指定の固有識別子を持つ周辺機器に接続することを試みます。

Declaration
宣言

  • func connect(toPeripheralWithUUID uuid: UUID, timeout: TimeInterval = 7, callback: ((CBPeripheral?, Error?) -> Void)? = nil)

Parameters
パラメータ

uuid

The unique identifier of the peripheral to attempt to connect to.
それに接続を試みることになる周辺機器の固有識別子。

timeout

The amount of time, in seconds, before the connection attempt is aborted. If the timeout value is nil, the attempt won’t time out. To cancel a connection attempt, call the disconnect(from:) method.
接続の試みが中断される前の時間、秒数で。timeout値がnilならば、その試みは中断しません。ある接続の試みをキャンセルするには、disconnect(from:)メソッドを呼び出してください。

callback

A function that’s called when the connection attempt succeeds or fails.
その接続の試みが成功または失敗する時に呼び出される関数。

connectToLastConnectedPeripheral(timeout:callback:)

Attempts to reconnect the central manager to the most recently connected peripheral.
セントラルマネージャをごく最近接続した周辺機器に再接続することを試みます。

Declaration
宣言

  • func connectToLastConnectedPeripheral(timeout: TimeInterval = 7.0, callback: ((CBPeripheral?, Error?) -> Void)? = nil) -> Bool

Parameters
パラメータ

timeout

The amount of time, in seconds, before the connection attempt is aborted. If the timeout value is nil, the attempt won’t time out. To cancel a connection attempt, call the disconnect(from:) method.
接続の試みが中断される前の時間、秒数で。timeout値がnilならば、その試みは中断しません。ある接続の試みをキャンセルするには、disconnect(from:)メソッドを呼び出してください。

callback

A function that’s called when the connection attempt succeeds or fails.
その接続の試みが成功または失敗する時に呼び出される関数。

Return Value
戻り値

A Boolean value indicating whether the currently active playground book has previously connected to a peripheral. If true, the central manager attempts to reconnect to it.
現在作動中のプレイグラウンドブックが以前にある周辺機器に接続したかどうかを指し示すブール値。trueならば、セントラルマネージャはそれに再接続を試みます。

disconnect(from:)

Disconnects the central manager from the specified, connected peripheral.
セントラルマネージャを指定の、接続された周辺機器から切断します。

Declaration
宣言

  • func disconnect(from peripheral: CBPeripheral)

Parameters
パラメータ

peripheral

The peripheral to disconnect from the central manager.
セントラルマネージャから切断する周辺機器。