インスタンスメソッド
activate(options:completionHandler:)
watchOS で非同期にオーディオセッションをアクティブにします。
watchOS 5.0+
宣言
func activate(
パラメータ
options
セッションをアクティブ化するときに適用するオプション。
completionHandler
操作が完了したときにシステムが呼び出すコールバック。
議論
並行処理に関する注意
このページに示すように、完了ハンドラーを使用して同期コードからこのメソッドを呼び出すことも、以下の宣言を持つ非同期メソッドとして呼び出すこともできます。
func activate(options: AVAudioSessionActivationOptions = []) async throws -> Bool
Swift の同時処理と非同期コードについては、Objective-C API の非同期呼び出し (Calling Objective-C APIs Asynchronously) を参照してください。
このメソッドを使用して、Apple Watch で音楽、ポッドキャスト、オーディオブックなどの長い形式のオーディオを再生します。このメソッドを呼び出して長い形式の再生をアクティブ化する前に、setCategory(_:mode:policy:options:) を呼び出し、カテゴリを playback に設定し、共有ポリシーを longForm 廃止 にルーティングしなければなりません。
このメソッドは、オーディオセッションを非同期的にアクティブにします。セッションが正常にアクティブ化されるとすぐに、またはアクティブ化が失敗した場合、システムは完了ハンドラーを呼び出します。
watchOS で長い形式のオーディオを再生するには、Bluetooth オーディオルートが必要です。必要に応じて、システムはオーディオルートピッカーをユーザーに提示し、ユーザーが Bluetooth ルートを選択できるようにします。ユーザーが以前に Bluetooth ルートを選択した場合、または AirPods またはその他の W1 搭載 Bluetooth ヘッドフォンが近くにある場合、システムはユーザーにピッカービューを表示せずにオーディオルートを自動的に選択します。該当する Bluetooth ルートが (自動的にまたはユーザーによって) 選択されていない場合、システムはエラーを完了ハンドラーに渡します。
注意
setActive(_:options:) メソッドの代わりに activate(options:completionHandler:) メソッドを使用して、他のカテゴリと共有ポリシーを承認できます。システムは、playback カテゴリと longForm ルート共有ポリシーのオーディオルートピッカーのみを提示します。
以下も見よ
オーディオセッションのアクティブ化
func setActive(Bool, options: AVAudioSession.SetActiveOptions)
指定されたオプションを使用して、あなたのアプリのオーディオセッションをアクティブ化または無効化します。
struct AVAudioSessionActivationOptions
オーディオセッションをアクティブ化するときに渡すオプションを説明する定数。