差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
translation:working:翻訳2 [2015-01-21 18:08] Decomo [AudioObject系ルーチン] |
translation:working:翻訳2 [2018-05-07 22:48] (現在) Decomo |
||
---|---|---|---|
行 4: | 行 4: | ||
オーディオHALは、それを通してアプリケーションがオーディオハードウェアへのアクセスを可能にする、抽象的概念を提供する。 | オーディオHALは、それを通してアプリケーションがオーディオハードウェアへのアクセスを可能にする、抽象的概念を提供する。 | ||
- | これを達成するために、HALはシステムの様々な構成部位へのアクセスを行う、小さなAudioObjectセットを備える。 | + | これを達成するために、HALはシステムの様々な構成部位へのアクセスを行う、小さな'' |
- | 全てのAudioObjectはプロパティの集合を持ち、状態の取得や操作を行うことが出来る。プロパティは三次元座標(ordered triple)的にアクセスされる。 | + | 全ての'' |
1つめの軸はプロパティを分類する(describe)セレクタである。 | 1つめの軸はプロパティを分類する(describe)セレクタである。 | ||
- | 他の2つの軸はAudioObjectの特定の部分を識別するスコープとエレメントで、その中からセレクタを探す。 | + | 他の2つの軸は'' |
- | AudioObjectPropertyAddress構造体はプロパティのアドレスをカプセル化する。 | + | '' |
プロパティの値は型付けされていないデータブロックで、その内容はセレクターの仕様に依存する。 | プロパティの値は型付けされていないデータブロックで、その内容はセレクターの仕様に依存する。 | ||
いくつかのセレクタは問い合わせ時に修飾データ(qualifier)を要求する。 | いくつかのセレクタは問い合わせ時に修飾データ(qualifier)を要求する。 | ||
行 15: | 行 15: | ||
プロパティ値の変化は常に非同期であることを考慮せよ。 | プロパティ値の変化は常に非同期であることを考慮せよ。 | ||
- | アプリケーションは AudioObjectHasProperty(), | + | アプリケーションは'' |
- | また、アプリはAudioObjectGetPropertyData()とAudioObjectSetPropertyData()でプロパティの値を操作する。 | + | また、アプリは'' |
- | アプリはAudioObjectAddPropertyListener()とAudioObjectRemovePropertyListener()で、プロパティの値が変化した際に呼ばれる関数の登録と削除を行う。 | + | アプリは'' |
- | The class of an AudioObject | + | '' |
オブジェクトのために利用可能なクラスセットは、ここで定義されているものに限られる。 | オブジェクトのために利用可能なクラスセットは、ここで定義されているものに限られる。 | ||
これら以外のクラスは存在しない。 | これら以外のクラスは存在しない。 | ||
クラスセットは、あるクラスがその親クラスのプロパティやルーチンを継承するといった、階層構造にまとめられている。 | クラスセットは、あるクラスがその親クラスのプロパティやルーチンを継承するといった、階層構造にまとめられている。 | ||
- | 全てのAudioObjectクラス群の基底クラスがAudioObjectクラスである。 | + | 全てのAudioObjectクラス群の基底クラスが'' |
- | そのようなものとして、AudioObjectクラスは、分類、人間が読める名前といった基本プロパティを提供し、各々のAudioObjectオブジェクトはそれらを持つ。 | + | そのようなものとして、'' |
- | 他の重要なクラスとして、AudioSystemObject, | + | 他の重要なクラスとして、'' |
HAL中のAudioObjectは包含階層で並べられている。 | HAL中のAudioObjectは包含階層で並べられている。 | ||
- | 階層の根本は1つで、それはAudioSystemObjectクラスの唯一のインスタンスである。 | + | 階層の根本は1つで、それは'' |
- | AudioSystemObjectのプロパティは、様々なデフォルトデバイスや通知ランループといった、プロセス全体にまたがる設定を表す。 | + | '' |
- | またAudioSystemObjectは利用可能な全てのAudioDeviceを持つ。 | + | また'' |
- | AudioDeviceクラスのインスタンスは個々のオーディオ装置をカプセル化したものである。 | + | '' |
- | AudioDeviceはIOの基本ユニットとしての役割を果たす。 | + | '' |
- | 1つのIOサイクルを提供し、サイクルに基づくタイミングソースや全てのバッファとサイクルの同期を提供する。 | + | '' |
- | The IO cycle presents all the synchronized buffers to the client in the same call out along with time stamps that specify the current time, when the input data was acquired and when the output data will be presented. | + | I/Oサイクルは同一呼び出し内で、全ての同期されたバッファを現在時間を指定するタイムスタンプと伴にクライアントに提供し、そしてその際、入力データが獲得され、また出力データも渡されるだろう。 |
- | AudioDeviceはAudioStreamクラスのインスタンスを含む。 | + | '' |
- | AudioStreamはユーザー・カーネル領域にまたがって転送されるデータの1つのバッファを表す。 | + | '' |
- | それだけに、AudioStreamはフォーマット情報の門番である。 | + | それだけに、'' |
各々がそれ自身のフォーマットと利用可能なフォーマットの一覧を持っている。 | 各々がそれ自身のフォーマットと利用可能なフォーマットの一覧を持っている。 | ||
- | AudioStreamは、エンコードされたフォーマットや非オーディオフォーマットを含む、あらゆる形式のデータを提供することが出来る。 | + | '' |
フォーマットがリニアPCMの場合、そのデータは常にネイティブエンディアンの32ビット浮動小数点数として表される。 | フォーマットがリニアPCMの場合、そのデータは常にネイティブエンディアンの32ビット浮動小数点数として表される。 | ||
ハードウェアの実際の物理フォーマットとの全ての変換は、デバイスドライバーによって行われる。 | ハードウェアの実際の物理フォーマットとの全ての変換は、デバイスドライバーによって行われる。 | ||
- | AudioDeviceとAudioStreamの両者は、AudioControlクラスあるいはその多くのサブクラスのインスタンスを含むことが出来る。 | + | '' |
- | AudioControlは、ゲイン、ミュート、データソース選択などといった、そのオブジェクトの特定の側面を表し、操作するプロパティを提供する。 | + | '' |
- | 多くの共通コントロールは、AudioDeviceかAudioStreamのプロパティとして利用可能である。 | + | 多くの共通コントロールは、'' |
===== AudioDevice系ルーチン ===== | ===== AudioDevice系ルーチン ===== | ||
行 85: | 行 85: | ||
|< - 4em >| | |< - 4em >| | ||
^AudioDeviceGetNearestStartTime^^^ | ^AudioDeviceGetNearestStartTime^^^ | ||
- | ^ 説明 | + | ^ 説明 |
^ 引数 | ^ 引数 | ||
^ ::: | AudioTimeStamp*ioRequestedStartTime | AudioTimeStampのポインタで、入力では要求開始時間を入れる。出力では、要求時間と同値ないし、それ以降が返る。これはそのデバイスの制限によって決定される。| | ^ ::: | AudioTimeStamp*ioRequestedStartTime | AudioTimeStampのポインタで、入力では要求開始時間を入れる。出力では、要求時間と同値ないし、それ以降が返る。これはそのデバイスの制限によって決定される。| | ||
行 363: | 行 363: | ||
? kAudioDevicePropertyModelUID | ? kAudioDevicePropertyModelUID | ||
: **CFString** | : **CFString** | ||
- | : AudioDeviceの型番の永続的な識別子。The identifier is unique such that the identifier from two AudioDevices are equal if and only if the two AudioDevices are the exact same model from the same manufacturer. | + | : AudioDeviceの型番の永続的な識別子。この識別子は、たとえ2つのAudioDeviceが同一製造元の全く同一のモデルだったとしても一意である。加えて、識別子はそのAudioDeviceが現れるマシンを問わず同一であるべきである。 |
? kAudioDevicePropertyTransportType | ? kAudioDevicePropertyTransportType | ||
: **UInt32** | : **UInt32** | ||
行 378: | 行 378: | ||
? kAudioDevicePropertyDeviceHasChanged | ? kAudioDevicePropertyDeviceHasChanged | ||
: **UInt32** (ただし値に意味はない) | : **UInt32** (ただし値に意味はない) | ||
- | : The type of this property is a UInt32, but it's value has no meaning. This property exists so that clients can listen to it and be told when the configuration of the AudioDevice | + | : このプロパティは、 クライアントによる' |
? kAudioDevicePropertyDeviceIsRunning | ? kAudioDevicePropertyDeviceIsRunning | ||
: **UInt32** | : **UInt32** | ||
行 408: | 行 408: | ||
? kAudioDevicePropertyUsesVariableBufferFrameSizes | ? kAudioDevicePropertyUsesVariableBufferFrameSizes | ||
: **UInt32** | : **UInt32** | ||
- | : A UInt32 that, if implemented by a device, indicates that the sizes of the buffers passed to an IOProc will vary by a small amount. The value of this property will indicate the largest buffer that will be passed and kAudioDevicePropertyBufferFrameSize will indicate the smallest buffer that will get passed to the IOProc. The usage of this property is narrowed to only allow for devices whose buffer sizes vary by small amounts greater than kAudioDevicePropertyBufferFrameSize. It is not intended to be a license for devices to be able to send buffers however they please. Rather, it is intended to allow for hardware whose natural rhythms lead to this necessity. | + | : 装置によって実装されている場合、IOProcに渡されるバッファサイズが微少に変化する事を示す。本プロパティ値は渡される最大バッファサイズを表し、そして'' |
+ | | ||
? kAudioDevicePropertyStreams | ? kAudioDevicePropertyStreams | ||
: **AudioStreamID配列** | : **AudioStreamID配列** | ||
行 440: | 行 441: | ||
: AudioDeviceのタイムスタンプによって計測された現在の実際のサンプリングレート。 | : AudioDeviceのタイムスタンプによって計測された現在の実際のサンプリングレート。 | ||
- | ==== AudioDevice Properties Implemented via AudioControl | + | ==== AudioControlオブジェクトを通じて実装されるAudioDeviceプロパティ |
? kAudioDevicePropertyJackIsConnected | ? kAudioDevicePropertyJackIsConnected | ||
行 464: | 行 465: | ||
: 0.0が完全に左、1.0が完全に右、0.5が中央の定位。 AudioControlのサブクラスAudioStereoPanControlで実装されている。 | : 0.0が完全に左、1.0が完全に右、0.5が中央の定位。 AudioControlのサブクラスAudioStereoPanControlで実装されている。 | ||
? kAudioDevicePropertyStereoPanChannels | ? kAudioDevicePropertyStereoPanChannels | ||
- | : **UInt32配列** | + | : **UInt32[2]** |
: An array of two UInt32s that indicate which elements of the owning object the signal is being panned between. This property is implemented by an AudioControl object that is a subclass of AudioStereoPanControl. | : An array of two UInt32s that indicate which elements of the owning object the signal is being panned between. This property is implemented by an AudioControl object that is a subclass of AudioStereoPanControl. | ||
? kAudioDevicePropertyMute | ? kAudioDevicePropertyMute | ||
行 494: | 行 495: | ||
? kAudioDevicePropertyPlayThru | ? kAudioDevicePropertyPlayThru | ||
: **UInt32** | : **UInt32** | ||
- | : 0はスルー再生が無効、1は有効を表す。AudioControlのサブクラスAudioMuteControlで実装されている。Further, the control that implements this property is only available through kAudioDevicePropertyScopePlayThrough. | + | : 0はスルー再生が無効、1は有効を表す。AudioControlのサブクラスAudioMuteControlで実装されている。さらにまた、本プロパティを実装するコントロールは、'' |
? kAudioDevicePropertyPlayThruSolo | ? kAudioDevicePropertyPlayThruSolo | ||
- | : A UInt32 where a value of 1 means that just that play through element is audible and the other elements are inaudible. The property is implemented by an AudioControl object that is a subclass of AudioSoloControl. Further, the control that implements this property is only available through kAudioDevicePropertyScopePlayThrough. | + | : **UInt32** |
+ | : | ||
? kAudioDevicePropertyPlayThruVolumeScalar | ? kAudioDevicePropertyPlayThruVolumeScalar | ||
- | : A Float32 | + | : **Float32** |
+ | : 音量制御の値を示す。範囲は0.0以上1.0以下である。本プロパティは'' | ||
? kAudioDevicePropertyPlayThruVolumeDecibels | ? kAudioDevicePropertyPlayThruVolumeDecibels | ||
- | : A Float32 | + | : **Float32** |
+ | : 音量制御の値をデシベルで示す。 本プロパティは'' | ||
? kAudioDevicePropertyPlayThruVolumeRangeDecibels | ? kAudioDevicePropertyPlayThruVolumeRangeDecibels | ||
- | : An AudioValueRange | + | : **AudioValueRange** |
+ | : コントロールが取りうるデシベル値の最小・最大を含む。 本プロパティは'' | ||
? kAudioDevicePropertyPlayThruVolumeScalarToDecibels | ? kAudioDevicePropertyPlayThruVolumeScalarToDecibels | ||
: A Float32 that on input contains a scalar volume value for the and on exit contains the equivalent dB value. This property is implemented by an AudioControl object that is a subclass of AudioVolumeControl. Further, the control that implements this property is only available through kAudioDevicePropertyScopePlayThrough. | : A Float32 that on input contains a scalar volume value for the and on exit contains the equivalent dB value. This property is implemented by an AudioControl object that is a subclass of AudioVolumeControl. Further, the control that implements this property is only available through kAudioDevicePropertyScopePlayThrough. | ||
行 533: | 行 538: | ||
: An AudioValueRange that contains the minimum and maximum dB values the control can have. This property is implemented by an AudioControl object that is a subclass of AudioLFEVolumeControl. | : An AudioValueRange that contains the minimum and maximum dB values the control can have. This property is implemented by an AudioControl object that is a subclass of AudioLFEVolumeControl. | ||
? kAudioDevicePropertySubVolumeScalarToDecibels | ? kAudioDevicePropertySubVolumeScalarToDecibels | ||
- | : A Float32 | + | : **Float32** |
+ | : スカラー音量値を入力すると、等価なデシベル値を出力する。本プロパティは'' | ||
? kAudioDevicePropertySubVolumeDecibelsToScalar | ? kAudioDevicePropertySubVolumeDecibelsToScalar | ||
- | : A Float32 | + | : **Float32** |
+ | : デシベル音量値を入力すると、等価なスカラー値を出力する。本プロパティは'' | ||
? kAudioDevicePropertySubMute | ? kAudioDevicePropertySubMute | ||
: **UInt32** | : **UInt32** | ||
行 541: | 行 548: | ||
| | ||
| | ||
- | ==== AudioStream | + | ==== AudioStreamプロパティ==== |
? kAudioStreamPropertyDirection | ? kAudioStreamPropertyDirection | ||
行 548: | 行 555: | ||
? kAudioStreamPropertyTerminalType | ? kAudioStreamPropertyTerminalType | ||
: **UInt32** | : **UInt32** | ||
- | : whose value describes the general kind of functionality attached to the AudioStream. | + | : '' |
? kAudioStreamPropertyStartingChannel | ? kAudioStreamPropertyStartingChannel | ||
: **UInt32** | : **UInt32** | ||
- | : that specifies the first element in the owning device that corresponds to element one of this stream. | + | : このストリームの1つのエレメントと一致する、親デバイス内の最初のエレメントを特定する。 |
? kAudioStreamPropertyLatency | ? kAudioStreamPropertyLatency | ||
- | : A UInt32 | + | : **UInt32** |
+ | : '' | ||
? kAudioStreamPropertyVirtualFormat | ? kAudioStreamPropertyVirtualFormat | ||
: **AudioStreamBasicDescription** | : **AudioStreamBasicDescription** | ||
行 569: | 行 577: | ||
=== Discussion === | === Discussion === | ||
- | AudioStream | + | '' |
+ | それらはマスターエレメントと、チャンネル毎にストリーム内で1から番号付けされるエレメントを持つ。 | ||
+ | '' | ||
+ | その結果として、'' | ||
+ | このようなプロパティには同じ定数が使用される。 | ||