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

インスタンスメソッド

presentAudioRecorder
Controller(withOutputURL:preset:
options:completion:)

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

watchOS 2.0+

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

func presentAudioRecorderController(
    withOutputURL URL: URL,
    preset: WKAudioRecorderPreset,
    options: [AnyHashable : Any]? = nil
) async throws -> Bool

パラメータ

URL

録音した出力ファイルの保存先となる URL を指定します。ファイル名の拡張子によって、録音する音声ファイルの種類が決まります。指定できる拡張子は、.wav、.mp4、.m4a です。

preset

録音品質。録音したい音声の種類を最もよく表す定数を指定してください。指定可能な値の一覧については、WKAudioRecorderPreset を参照してください。

options

録音時に使用するオプションの辞書です。このパラメータに nil を指定すると、音声録音インターフェースはデフォルトのオプションを使用します。辞書に含めることができるキーと値の一覧については、音声録音オプションを参照してください。

completion

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

didSave

指定された URL に音声が正常に保存されたかどうかを示すブール値。音声が保存された場合は true、ユーザーが録音をキャンセルした場合は false になります。

error

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

以下で言及

シーン間の移動

議論

このメソッドを使用して、ユーザーから録音された音声を取得します。このメソッドは非同期で実行され、呼び出し後すぐに戻ります。次のランループサイクル中に、システムは音声録音コントローラをユーザーに表示します。インターフェイスには、インターフェイスを閉じるためのキャンセルボタンと、録音を管理するためのコントロールが含まれています。音声が録音されると、インターフェイスには WKAudioRecorderControllerOptionsActionTitleKey オプションで指定されたタイトル文字列が表示され、ユーザーはその内容を受け入れて指定された URL に保存できます。ユーザーがキャンセルボタンまたはタイトル文字列をタップすると、WatchKit は音声録音インターフェイスコントローラを自動的に閉じます。

ユーザーがインターフェースを閉じたり、プログラムで閉じたりすると、システムは完了処理ブロックを呼び出します。このブロックを使用して結果を処理してください。

このメソッドは必ず WatchKit 拡張機能のメインスレッドから呼び出してください。

ファイル名に拡張子「.wav」を指定すると、生成される音声フォーマットは LPCM になります。その他のファイル形式の場合は、音声フォーマットは AAC になります。音声録音オプションの詳細については、WKAudioRecorderPreset の値を参照してください。