プロパティの設定

サポートされている各プロパティは、VehiclePropConfig 構造によって定義されるプロパティの構成で指定され、各プロパティには以下のフィールドがあります。

フィールド	説明
`prop`	プロパティ ID。この ID はサポートされているシステムプロパティまたはベンダープロパティからの定義済みシステムプロパティのいずれかである必要があります。プロパティ ID は、以下のフィールドのビット OR を使用して構築されます（右から左）。 (0x00000000) 16 ビット: 0x0100 - 0xffff の範囲の一意の ID。 (0x00000000) 8 ビット: プロパティのタイプを定義するプロパティタイプ。 (0x00000000) 4 ビット: エリアタイプ。 (0x00000000) 4 ビット: `VehiclePropertyGroup`> `SYSTEM` (0x10000000) または `VENDOR` (0x20000000) のいずれか。カスタマイズ可能なプロパティについては、ベンダープロパティをご覧ください。たとえば、 `INFO_VIN (0x11100100) = UniqueID (0x00000100) \| VehiclePropertyType.STRING (0x00100000) \| VehicleArea.GLOBAL (0x01000000) \| VehiclePropertyGroup.SYSTEM (0x10000000)` です。
`access`	プロパティのアクセスモード。`READ`、`WRITE`、`READ_WRITE` のいずれかにする必要があります。サポートされているシステムプロパティで定義されているアクセスモードと同じである必要があります。
`changeMode`	プロパティの変更モード。`STATIC`、`ON_CHANGE`、`CONTINUOUS` のいずれかにする必要があります。`STATIC` は、システム起動後に変更されることのないプロパティ値を意味します。`ON_CHANGE` は、値の変更時に VHAL がレポートする必要があることを意味します。`CONTINUOUS` は、プロパティ値が継続的に変更され、VHAL はサブスクリプションのサンプルレートに基づいてレポートしなければならないことを意味します。変更モードは、サポートされているシステムプロパティで定義される変更モードと同じである必要があります。
`configArray`	プロパティ固有の構成を含む任意の配列。これは空でもかまいません。
`configString`	プロパティ固有の構成を含む任意の文字列。これは空でもかまいません。
`minSampleRate`、`maxSampleRate` 継続プロパティのサポートされている最小と最大のサンプルレート。プロパティが継続的でない場合は使用されません。

プロパティのタイプ

VehiclePropertyType.aidl で列挙型として定義されます。サポートされているプロパティのタイプを以下の表に示します。

プロパティのタイプ	値	説明
STRING	0x00100000	文字列プロパティ。車両プロパティ値で `stringValue` フィールドを使用します。
BOOLEAN	0x00200000	ブール値プロパティ。`int32Values` フィールドの最初の要素を車両プロパティ値で使用します。`0` は `false`を、`None 0` は `true` を意味します。
INT32	0x00400000	整数プロパティ。`int32Values` フィールドの最初の要素を車両プロパティ値で使用します。
INT32_VEC	0x00410000	Integer[] プロパティ。`int32Values` フィールドの要素を車両プロパティ値で使用します。
INT64	0x00500000	Long 型プロパティ。`int64Values` フィールドの最初の要素を車両プロパティ値で使用します。
INT64_VEC	0x00510000	`Long[]` プロパティ。`int64Values` フィールドの要素を車両プロパティ値で使用します。
FLOAT	0x00600000	Float プロパティ。`floatValues` フィールドの最初の要素を車両プロパティ値で使用します。
FLOAT_VEC	0x00610000	Float[] プロパティ。`floatValues` フィールドの要素を車両プロパティ値で使用します。
BYTES	0x00700000	byte[] プロパティ。`byteValues` フィールドの要素を車両プロパティ値で使用します。
MIXED	0x00e00000	混合型のプロパティ。スカラー型またはベクター型の任意の組み合わせ。プロパティの構成で config 配列に正確な形式を指定する必要があります。ベンダー混合型のプロパティの場合、configArray はこの構造でフォーマットする必要があります。 configArray[0]。1 はプロパティに文字列値があることを示します configArray[1]。1 はプロパティに Boolean 値があることを示します configArray[2]。1 はプロパティに整数値があることを示します configArray[3]。数はプロパティの Integer[] の大きさを示します configArray[4]。1 はプロパティに Long 値があることを示します configArray[5]。数はプロパティの Long[] の大きさを示します configArray[6]。1 はプロパティに浮動小数点値があることを示します configArray[7]。数はプロパティの Float[] の大きさを示します configArray[8]。数はプロパティの byte[] の大きさを示します。たとえば、`configArray = {1, 1, 1, 3, 0, 0, 0, 0, 0}` はプロパティに文字列値、Boolean 値、整数値、3 つの整数を使用した配列があることを示します。

エリア ID 構成

各プロパティ構成には、エリア ID 構成のリストが含まれる場合もあります。このリストは、グローバルプロパティについては任意、ゾーンプロパティには必須です（複数のサポート対象エリアがあるプロパティ）。各エリア ID 構成には以下のフィールドがあります。

フィールド	説明
`areaId`	このエリアの ID。エリア ID をご覧ください。
`minInt32Value`、`maxInt32Value`	INT32 型プロパティの任意の最小値と最大値。その他のタイプはすべて無視されます。どちらも 0 の場合は無視されます。グローバルプロパティでは、最小値と最大値を定義する必要がある場合は、エリア ID が 0 の 1 つのエリア構成を使用する必要があります。
`minInt64Value`、`maxInt64Value`	INT64 型プロパティの任意の最小値と最大値。その他のすべてのタイプが無視されます。どちらも 0 の場合は無視されます。グローバルプロパティでは、最小値と最大値を定義する必要がある場合は、エリア ID が 0 の 1 つのエリア構成を使用する必要があります。
`minFloatValue`、`maxFloatValue`	Float 型プロパティの任意の最小値と最大値。その他のタイプはすべて無視されます。どちらも 0.0 の場合は無視されます。グローバルプロパティでは、最小値と最大値を定義する必要がある場合は、エリア ID が 0 の 1 つのエリア構成を使用する必要があります。
（Android 14 の新機能） `supportedEnumValues`	プロパティが列挙型プロパティとして定義されている場合にサポートされる値の任意のリスト。指定されていない（空）または Android 14 より前のバージョンの場合、すべての列挙値がサポートされていると想定されます。グローバルプロパティでは、サポートされている列挙値を定義する必要がある場合は、エリア ID が 0 の 1 つのエリア構成を使用する必要があります。

エリアタイプ

VehicleArea.aidl で列挙型として定義されます。サポートされているエリアタイプを以下に示します。

エリアタイプ	値	説明
GLOBAL	0x01000000	このプロパティはグローバルプロパティで、複数のエリアはありません。
WINDOW	0x03000000	窓に基づくエリア。`VehicleAreaWindow` 列挙値を使用します。
MIRROR	0x04000000	ミラーに基づくエリア。`VehicleAreaMirror` 列挙値を使用します。
SEAT	0x05000000	シートに基づくエリア。`VehicleAreaSeat` 列挙値を使用します。
DOOR	0x06000000	ドアに基づくエリア。`VehicleAreaDoor` 列挙値を使用します。
WHEEL	0x07000000	車輪に基づくエリア。`VehicleAreaWheel` 列挙値を使用します。

各ゾーンプロパティでは、事前定義したエリアタイプを使用する必要があります。各エリアタイプには、エリアタイプの列挙値で定義されたビットフラグのセットがあります。たとえば、SEAT エリアでは、VehicleAreaSeat 列挙型が定義されています。

ROW_1_LEFT = 0x0001
ROW_1_CENTER = 0x0002
ROW_1_RIGHT = 0x0004
ROW_2_LEFT = 0x0010
ROW_2_CENTER = 0x0020
ROW_2_RIGHT = 0x0040
ROW_3_LEFT = 0x0100
...

エリア ID

ゾーンプロパティはエリア ID によって区別されます。ゾーンプロパティはそれぞれ、複数のエリア ID をサポートできます。エリア ID は、それぞれの列挙値からの 1 つ以上のフラグで構成されます。たとえば、VehicleAreaSeat を使用するプロパティでは次のようなエリア ID を使用します。

アイテム	説明
`ROW_1_LEFT \| ROW_1_RIGHT`	このエリア ID は、左右の前部座席に適用されます。
`ROW_2_LEFT`	後部の左シートにのみ適用されます。
`ROW_2_RIGHT`	後部の右シートにのみ適用されます。

詳しくは、HVAC をご覧ください。