連絡先を使用すると、Glassware が作成していないタイムライン アイテムを受け取れます。 タイムライン アイテムは、カードのタップ操作によって連絡先と明示的に共有する必要があります。 [共有] メニュー項目。
仕組み
共有の連絡先を作成すると、タイムライン カードの共有の通常のフローは次のようになります。
- 連絡先を作成し、連絡先がサポートする MIME タイプを定義します。
- ユーザーのタイムラインに連絡先を挿入します。
- ユーザーが [共有] メニュー項目を含むタイムライン アイテムを受け取ります。Glassware では、ユーザーが自分のアイテムをこのメニュー アイテムと共有できるように明示的に許可する必要があります。
- ユーザーがタイムライン アイテムをタップし、[共有] メニュー項目を選択して、連絡先を選択します。
- Mirror API は、共有されたタイムライン カードのコピーを作成し、連絡先にそのコピーへのアクセス権を付与して、そのコピーをユーザーのタイムラインに挿入します。Glassware は元のタイムラインアイテムにアクセスできません。
- もし 通知の共有に登録している タイムライン カードの識別情報を含むペイロードを受け取ります。 続けて、コマンドでタイムライン アイテムを取得できます。 Timeline.get。
- 共有タイムライン カードを変更し、既存のタイムライン カードを更新する Timeline.update。
アフィリエイト住所表示オプションの目的
デフォルトでは、Glassware は作成していないタイムライン アイテムにはアクセスできません。 連絡先が、ユーザーの同意を得たうえで Glassware から Glassware へのデータ共有を許可するようにします。
Glassware では、主に次の 2 つの方法で連絡先を使用できます。
タイムライン アイテムを他の連絡先と共有できるようにする:
SHAREの組み込みメニュー項目 追加できますユーザーが共有メニュー アイテムをタップすると、リストが表示され、 共有できる連絡先が表示されます。タイムライン アイテムを Glassware と共有できるようにする: 連絡先を作成します 作成しますユーザーがタイムライン カードを共有したい場合、 連絡先が選択肢として表示されます。また、kubectl の「get」コマンドや 使用可能な MIME タイプ 関心のあるカードのみに連絡先が表示されるようにします ユーザーがタイムライン カードを連絡先と共有したときに通知を受け取るには、次の操作を行います。 タイムライン通知に登録できます。
連絡先の作成
ユーザーがタイムライン アイテムを Glassware と共有できるようにするには、 メッセージを POST で送信して、 連絡先の JSON 表現を REST エンドポイントを挿入します。
すべての連絡先で、Glassware への連絡先を識別する id を指定する必要があります。
通知を受信できます。また、kubectl の
displayName と、Glass が表示に使用する少なくとも 1 つの imageUrls
連絡先情報をユーザーに提示します。
未加工の HTTP
POST /mirror/v1/contacts HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}
{
"id": "harold"
"displayName": "Harold Penguin",
"iconUrl": "https://developers.google.com/glass/images/harold.jpg"
"priority": 7
}
共有通知への登録
Mirror API を使用すると 通知を受け取る スペースでユーザーが特定の操作を行ったときに送信される タイムライン項目またはユーザーの位置情報が が更新されました。通知に登録すると、 通知を処理するコールバック URL を提供します。
Mirror API からの通知は、POST リクエストとして
JSON リクエスト本文を含むサブスクライブされたエンドポイント。
未加工の HTTP
{
"collection": "timeline",
"itemId": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
"operation": "INSERT",
"userToken": "harold_penguin",
"verifyToken": "random_hash_to_verify_referer",
"userActions": [
{
"type": "SHARE"
}
]
}
itemId 属性は、共有タイムライン アイテムの ID です。
Timeline.get でタイムライン アイテムを取得します。
次の例は、写真が添付された一般的なタイムライン アイテムを示しています。
{
"id": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
"attachments": [
{
"contentType": "image/jpeg",
"id": "<ATTACHMENT_ID>"
}
],
"recipients": [
{
"kind": "glass#contact",
"source": "api:<SERVICE_ID>",
"id": "<CONTACT_ID>",
"displayName": "<CONTACT_DISPLAY_NAME>",
"imageUrls": [
"<CONTACT_ICON_URL>"
]
}
]
}
サービスが API に 200 OK HTTP ステータスを返す
コードを返します。
サービスからエラーコードが返された場合、Mirror API が
サービスに通知を再送信してみてください。
音声文字変換の受信
メインの音声メニューから、文字起こしした音声を連絡先と共有できます。 現在、連絡先が使用できる音声コマンドは 2 つあります。
- 「メモして」
- 「最新情報を投稿して」
たとえば、ユーザーはチポトレの 次の誕生日に、「OK Glass... 最新情報を投稿して...」というフレーズを含む ねこストリーム...明日はチポトレの誕生日です！
音声コマンドを使用するには:
具体的な
acceptCommandsプロパティをtype:{ ... "displayName": "Cat Stream", "id": "CAT_STREAM", "acceptCommands": [ {"type": "POST_AN_UPDATE"} ] }タイムライン通知に登録する 通知を受け取ることができます。Glassware は 次のようなメッセージが表示されます。
{ "collection": "timeline", "operation": "UPDATE", "userToken": "<USER_TOKEN>", "verifyToken": "<VERIFY_TOKEN>", "itemId": "<ITEM_ID>", "userActions": [ {"type": "LAUNCH"} ] }itemIdを使用してタイムライン アイテムを取得します。{ "id": "<ITEM_ID>", "text": "Chipotle's birthday is tomorrow", "recipients": [ {"id": "CAT_STREAM"} ] }複数の Glassware で同じ音声コマンドで連絡先が登録されている場合は、 第 2 レベルのメニューが表示され、 各連絡先の
displayName。 ユーザーは、選択した連絡先を話すことができます。連絡先のdisplayNameに含まれる文字列 発音がわからない文字や発音でない場合、speakableNameプロパティ 共有の連絡先の発音を宣言します。
共有された写真の説明
ユーザーは、付属のアプリを使って、あなたの Glassware と写真を共有できます。 生成 AI です。一般的なユーザーフローは次のとおりです。