このガイドラインは、よくある落とし穴を回避し、高品質の Glassware を作成するプロセスを順を追って説明しています。
呼び出し
Glassware が承認済みの音声コマンドを使用していることを確認します。
Glassware が承認済みのコンテキスト コマンドを使用していることを確認します。
Mirror API は、ユーザーからのリクエストを受信し、リアルタイムで、または低レイテンシで応答するようには設計されていません。これが要件である場合は、GDK を使用します。
たとえば、Mirror API Glassware は、「メモして」や「更新を送信」コマンドで適切に機能します。ユーザーは、コマンドを呼び出した後、Glassware からのレスポンスを待つ必要がないからです。
一方、「タイマーを開始」や「楽器をチューニング」は、ミラー API Glassware ではうまく機能しません。ユーザーはすぐに使い始めることを期待しているからです。
ユーザーが Glassware とその機能を起動する主な方法は 2 つあります。OK Glass のメインメニューから音声コマンドまたはタップするか、タイムライン カードのコンテキスト メニューから使用します。
Glassware を起動するために、メニューカードをタイムライン カードに固定することは強制しないでください。Mirror API は、ユーザー構成の設定に基づく定期的な通知や、連絡先とコンテンツを共有するように設計されています。
GDK Glassware を起動したり Mirror API を呼び出すためのメニュー項目を指定しても、エクスペリエンスが定期的な通知のデザイン パターンに一致し、すぐに操作できるよう Mirror API を使用していない場合は問題ありません。
たとえば、ペットの世話に関する Glassware は、タイムライン カードを挿入して、後でユーザーがその機能を固定できるよう強制しないでください（例: 「犬の検索」、「猫の検索」、「鳥など」）。代わりに、Glassware では、ユーザーが希望するペットの条件を設定し、この条件を満たすカードを定期的に配信できるようにする必要があります。このカードには、「プロフィールを読む」や「ペットを採用」などのアクションを実行するメニュー項目を含めることができます。
Glassware を明示的に呼び出している場合は、実行中の Glassware であることをユーザーが明確に示す必要があります。
デザイン
Glass は、小さな情報を適切なタイミングで配信するように設計されています。モバイルアプリからすべての機能を移植しても、Glass ではうまくいきません。その代わりに、Glass で適切に動作する主なユースケースを見つけ、いくつかのマジック的な機能の提供に注力します。Glass のデザインをご覧ください。
- ライブカードをタップすると、常に Glass メニューが表示されます。タイムラインからライブカードを閉じるには、すべてのライブカードに [Stop] メニュー項目が必要です。
- ライブカードが没入型になると、ユーザーは中断したところから没入型の画面に戻ります。
- スワイプやタップで没入感を高めるには、操作が一度も使用されなかったアクションやフィードバック（水平方向のジョギングなど）を使うようにします。
- Glass システムのように動作しないジェスチャーでは、使用方法と明確な結果が必要です。
- Glass システムが提供するものと同様の UI 要素を作成する場合は、代わりに Glass システムから提供されるものを使用してください。たとえば、独自のビューを実装する代わりにカード スクロール ビューを使用します。
- 集中させる必要があるタスクには没入感を使用します。それ以外の場合は、ライブカードや静的カードなどの他のオプションが優先されます。
可能であれば、承認されたカードデザインを使用してください。Mirror API と GDK のテンプレートは、これらの設計の一部で使用できます。
- Mirror API を使用している場合は、base_style.css のスタイルを使用します。
- 組み込みのテンプレートとして、パディングとスペースを使用する一般的なルールに従います。
バンドルとページネーションを使用すると、カードをグループ化できます。ただし、次の状況ではカードを正しく使用してください。
注: バンドルとページ設定機能は Mirror API に組み込まれています。GDK で同じ機能を実現しようとしている場合は、Mirror API が可能な限りバンドルとページネーションを提示する方法を模倣してください。スタック インジケーター、メニュー項目、カード スクローラーを使用してカードを表示します。
バンドル
- 類似しているが、同じカード上にあるべきではないカードのグループには、バンドルを使用します。
- バンドルのカバーカードは、バンドルに含まれるカードとは視覚的に異なるダイジェストとして設計します。
- 通知音は、バンドルごとに 1 回だけユーザーに知らせます。
一括販売が効果的であるケース:
- メールまたは短いメッセージのスレッド
- 同じユーザー間で 3 つの SMS メッセージ
- 1 時間以内に撮影した 5 枚の写真
- 関連記事を一度に挿入しました
- 開催中のスポーツゲームの主なイベントとスコアの最新情報のリスト
一括販売がうまく機能しない場合:
- サービスのすべてのコンテンツ
- 1 日に多数の広告見出しが Glass に送信される
ページ分け
スペースに制約があるため 1 つのカードに収まらないタイムライン アイテムにはページ分けを使用しますが、同じカードには配置しないでください。
ページ分けが適切に機能しているケース:
- 1 枚のカードに収まらない単一のメール、ニュース記事、または同様のコンテンツ
ページ分けがうまくいかない場合:
- 複数のカードやニュースなど、固有のカードのグループ
Glassware は、他の Glassware のおすすめの方法に沿っていることを確認してください。
ウェブ プロパティ
- ウェブから Glass にコンテンツを送信する場合は、Glass に送信するアイコンを使用します。
- Glassware をダウンロードするためのリンクを提供する場合は、[Get it on Glass] アイコンを使用します。
- 正しい文法と表記を使用します。
- 承認ページまたはログインページは 2 つまでです。
- 設定で、妥当な期間内（3 か月未満）に再承認を要求しないようにしてください。
- アカウントまたはコンパニオン アプリが必要な場合、サービス アカウントを持っているユーザーと持っていないユーザーの認証フローはクリアされます。
- 認可ウェブページの URL は、設定ウェブページの URL とは異なる必要があります。
- ユーザー アカウントが必要な場合、Glassware はユーザー アカウントに接続しない限りユーザーを認証できません。
- 設定の変更が保存されていることを視覚的に示します。
- 該当する場合は、コンテンツの関連性を維持するため、全体とフィードごとの更新頻度を示します。次のスクリーンショットは、ユーザーが更新頻度とフィードタイプを設定できるようにする例を示しています。
ブランディング
Glass ブランドとその関連アセットは Google 独自のものであり、Google によって慎重に設計、使用されています。
- [アセット](/glass/tools-downloads/downloads) ページで提供されていない限り、Glass 独自のロゴやアセットを使用、変更、または模倣しないでください。
- 製品で使用するために Glass ロゴのフォントの使用、変更、模倣を行わないでください。
書き込み
Glassware とそれに関連する説明は、デフォルトで英語である必要があります。複数の言語間で機能が完全に同等であれば、複数の言語を使用できます。
Glassware の名前が Glassware の機能やブランディングを正確に表していることを確認する。「for Glass」というフレーズでない限り、名前に「Glass」という文字列を使用しないでください。たとえば、「Glass Facts for Glass」は問題ありませんが、「Glass Cat Facts」や「Glassy Cat Photos」は認められません。
制限事項とガイドラインについては、テキスト メッセージの Glass をご覧ください。
ガイドラインに沿って文章を作成してください（該当する場合）。
テスト
Glassware は、実際の Glass ハードウェア上で実行します。これは、ユーザー エクスペリエンスを正確に測定する唯一の方法です。また、Glass の過熱など、GDK Glassware によって予期しないパフォーマンスが発生しないようにしてください。