HomeKit の用語とホームのレイアウト
HomeKit は、ホームをオブジェクトの階層としてモデル化し、それらを参照する用語の語彙を定義します。Home アプリは、HomeKit オブジェクトモデルと用語を使用して、人々が声、アプリ、自動化によってアクセサリを直感的に制御できるようにします。
あなたのアプリで HomeKit が定義する用語とオブジェクトモデルを使用することは非常に重要です。これにより、人々の理解を深め、ホームオートメーションを親しみやすくすることができます。
ホーム
HomeKit では、home (ホーム) という用語を使用して、実際の家、オフィス、またはユーザーに関連するその他の場所を表します。1 人のユーザーが複数のホームを持つことができます。
ホーム
オフィス
ルーム
Room (ルーム) は、家の中の実際の部屋を表します。部屋には、サイズや場所などの属性はありません。ベッドルーム (寝室) や オフィス など、人々にとって意味のある名前にすぎません。アクセサリを部屋に割り当てるときは、"Siri、寝室以外のすべての照明をつけて" や "Siri、キッチンと玄関の照明をつけて" などの音声コマンドを使用できます。
アクセサリ、サービス、および特徴
アクセサリ という用語は、シーリング ファン、ランプ、ロック、カメラなど、接続された実際のホームアクセサリを表します。HomeKit は カテゴリ を使用して、サーモスタット、ファン、ライトなどのアクセサリの種類を表します。通常、アクセサリメーカーは各アクセサリをカテゴリに割り当てますが、あなたのアプリは必要に応じてユーザーがこの割り当てを行うのを支援します。たとえば、ファンやランプに接続されているスイッチは、それが制御するアクセサリと同じカテゴリに割り当てる必要があります。
接続されたライトのスイッチなど、アクセサリの制御可能な機能は サービス と呼ばれます。一部のアクセサリは、複数のサービスを提供します。たとえば、接続されたガレージドアを使用すると、人々はライトとドアを個別に制御できます。また、接続されたコンセントを使用すると、上部のコンセントと下部のコンセントを個別に制御できます。アプリは UI で サービス という言葉を使用しません。代わりに、ガレージドア開閉器 や 天井のファンライト など、サービスを説明する名前を使用します。人々は Siri を使用して自宅のアクセサリを制御する場合、アクセサリの名前ではなく、サービスの名前を話します。命名の詳細なガイダンスについては、便利な名前を選択できるように を参照してください。
特徴 は、サービスの制御可能な属性です。たとえば、天井の扇風機では、扇風機のサービスに速度の特徴があり、照明のサービスには明るさの特徴があります。アプリは、UI で 特徴 という単語を使用しません。代わりに、速度 や 明るさ などの属性を表す用語を使用します。
サービスのグループ は、ユーザーが 1 つの単位として制御するアクセサリ サービスのグループを表します。たとえば、ユーザーは、3 つのサービスすべてを 読書灯 という名前のサービスのグループに割り当てることで、リビングルームの 1 つの隅にあるフロアランプと 2 つのテーブルランプを制御できます。読書灯 サービスグループを使用すると、ユーザーはリビングルームの他のすべての照明とは別に、これら 3 つの照明を制御できます。
アクションとシーン
アクション という用語は、扇風機の速度や照明の明るさを調整するなど、サービスの特徴を変更することを指します。アクションは、ユーザーと自動化によって開始されます。
シーン は、1 つ以上のアクセサリで 1 つ以上のサービスを制御するアクションのグループです。たとえば、ユーザーは、リビングルームのシェードを下げて照明を暗くする 映画の時間 シーンや、キッチンの照明を付けてシェードを上げ、コーヒーメーカーを起動する おはよう シーンを作成できます。
ヒント
HomeKit API では、シーンの代わりに アクションセット という用語を使用します。あなたのアプリの UI では、常に シーン という用語を使用してください。
自動化
自動化 により、ユーザーの位置が変化したとき、特定の時刻になったとき、別のアクセサリがオンまたはオフになったとき、センサーが何かを検出したときなど、特定の状況にアクセサリが反応します。たとえば、自動化により、日没時またはユーザーが帰宅したときに家の照明をオンにすることができます。
ゾーン
ゾーン は、2 階 や 1 階 など、複数の部屋を含む家のエリアを表します。ゾーンの設定はオプションですが、そうすることで、人々が複数のアクセサリを一度に制御できるようになります。たとえば、1 階のすべての照明を downstairs という名前のゾーンに割り当てると、人々は "Siri、downstairs のすべての照明を消して" などの音声コマンドを使用できるようになります。
ホームレイアウト
HomeKit モデルでは、ホーム オブジェクトは、ルーム、アクセサリ、ゾーン など、他のすべてのオブジェクトを含む階層のルートです。ユーザーに複数のホームがある場合、各ホームは異なる階層のルートになります。
HomeKit が使用する階層モデルを承認して下さい。 あなたのアプリの UI 内でルームやゾーンごとにアクセサリを整理していない場合でも、人々がアクセサリを設定または制御できるようにするには、HomeKit モデルを参照する必要があります。Siri と HomePod を使用して、"Siri、2 階の照明をつけて"、"ここは暗い" などのコマンドを発声して制御できるように、人々はアクセサリがどこにあるかを知る必要があります。詳細なガイダンスについては、Siri の操作 を参照してください。
アクセサリに関連する HomeKit の詳細を人々が簡単に見つけられるようにします。 あなたのアプリの構成がアクセサリに重点を置いている場合は、アクセサリのゾーンやルームなど、他の HomeKit 情報を見つけにくい設定スクリーンで非表示にしないでください。代わりに、関連する HomeKit 情報をアクセサリの詳細ビューで簡単に利用できるように検討してください。
ユーザーは複数のホームを持てることを認識してください。 あなたのアプリがユーザーごとに複数のホームを持てる概念をサポートしていない場合でも、アクセサリの詳細ビューで関連するホームの情報を提供することを検討してください。
重複するホームの設定を提示しないでください。 あなたのアプリがホームの構成について異なる視点を持っている場合は、ホームのすべてまたは一部を再度設定するように求めたり、重複した設定ビューを表示したりして、人々を混乱させないでください。人々が Home アプリで行った設定に常に従い、これらの詳細をあなたの UI に表示する直感的な方法を見つけてください。
リソース
関連
開発者用文書
HomeKit (HomeKit)