元のドキュメント： developer.apple.com/documentation/watchkit/wkinterfacecontroller/presentmediaplayercontroller(
with:options:completion:)

インスタンスメソッド

presentMediaPlayerController(with:
options:completion:)

指定されたメディアファイルを再生するためのモーダルインターフェースを表示します。

func presentMediaPlayerController(
    with URL: URL,
    options: [AnyHashable : Any]? = nil,
    completion: @escaping (Bool, TimeInterval, (any Error)?) -> Void
)

func presentMediaPlayerController(
    with URL: URL,
    options: [AnyHashable : Any]? = nil
) async throws -> (Bool, TimeInterval)

パラメータ

URL

再生したいメディアファイルの URL。URL はファイルを指定しなければならず、ストリーミングメディアはサポートされていません。ファイルには音声、動画、またはその両方を含めることができます。

リモートサーバー上のファイルの URL を指定した場合、このメソッドはまずファイルをダウンロードし、処理の進行状況を示すプログレスインジケーターを表示します。WatchKit は Web サーバーからファイルをダウンロードする際に App Transport Security（ATS）を使用するため、ファイルはセキュアなサーバー上に存在し、URL は https スキームを使用しなければなりません。サーバーが ATS レベルのセキュリティをサポートしていない場合は、再生前にファイルを自分でダウンロードしてください。

options

メディアファイルの再生オプションの optional の辞書です。辞書に含めるべきキーの一覧については、メディアプレーヤーのオプション を参照してください。

completion

再生終了時に実行されるべきブロック。このブロックを使用して、再生の状態を判断し、必要なクリーンアップを実行します。このブロックは戻り値がなく、以下のパラメータを取ります。

didPlayToEnd

メディアファイルの再生が完了したかどうかを示すブール値。メディアファイルの終わりに達した場合は true、再生が途中で終了した場合は false になります。

endTime

再生が終了した時刻（秒単位）。didPlayToEnd パラメータが false の場合、このプロパティの値を使用して再生が停止した時刻を特定できます。コンテンツを再度再生する場合、この値を開始時刻として使用できます。

error

問題が発生した場合は、エラーオブジェクトが返されます。エラーオブジェクトを使用して問題の原因を特定し、ユーザーへの通知など、適切な措置を講じてください。

以下で言及

シーン間の移動

議論

このメソッドを使用して、短いメディアクリップをユーザーに提示します。このメソッドは非同期的に実行され、呼び出し後すぐに戻ります。その後の実行ループのサイクルで、システムは現在のインターフェイスコントローラの前面にメディアインターフェイスコントローラを表示します。動画の場合、インターフェイスコントローラは動画コンテンツに加え、再生の開始や停止を行うためのコントロールを表示します。音声の場合、インターフェイスコントローラは再生中のコンテンツに関する情報を表示します。このメソッドは、必ず WatchKit 拡張機能のメインスレッドから呼び出してください。

ユーザーがインターフェイスを閉じた場合、またはプログラムによってメディアプレーヤーを閉じた場合、WatchKit は completion パラメータで指定されたブロックを呼び出します。このブロックを使用して、メディアファイル数の再生状況やその他の関連情報を取得できます。例えば、再生を停止した位置を記録しておき、後で同じクリップをその位置から再生するといったことが可能です。

以下の表は、メディアファイルを作成する際に使用すべきコード化情報をまとめたものです。あなたのアプリから直接再生する音声や動画の素材については、クリップを比較的短く抑えるようにしてください。クリップを短くすることで、ディスク容量や電力の消費を抑え、ダウンロードにかかる時間も短縮できます。

このメソッドを使用して再生する全ての音声は、ペアリングされた Bluetooth オーディオデバイスが利用可能な場合はそのデバイスに出力されます。Bluetooth オーディオデバイスが利用できない場合は、Apple Watch のスピーカーから出力されます。

以下も見よ

映像・音声インターフェースの表示

メディアプレーヤーのオプション

メディア再生オプションを示すキー。

func dismissMediaPlayerController()

メディアインターフェースコントローラーを閉じます。

func presentAudioRecorderController(withOutputURL: URL, preset: WKAudioRecorderPreset, options: [AnyHashable : Any]?, completion: (Bool, (any Error)?) -> Void)

ユーザーの Apple Watch から音声を録音するための標準インターフェイスを表示します。

enum WKAudioRecorderPreset

音声録音の品質を示す定数。

音声録音オプション

音声を録音する際に指定すべきオプション。

func dismissAudioRecorderController()

音声録音インターフェースコントローラーを閉じます。