Kontak

Kontak memungkinkan Glassware menerima item linimasa yang tidak dibuatnya. Pengguna harus secara eksplisit membagikan item linimasa kepada kontak Anda dengan mengetuk Item menu Bagikan.

Cara kerjanya

Setelah Anda membuat kontak berbagi, berbagi kartu linimasa mengikuti alur umum berikut:

1. Buat kontak dan tentukan jenis MIME yang didukung kontak Anda.
2. Menyisipkan kontak ke linimasa pengguna Anda.
3. Pengguna menerima item linimasa yang memiliki item menu Bagikan. Gelas harus secara eksplisit mengizinkan pengguna untuk berbagi item mereka dengan item menu ini.
4. Pengguna mengetuk item linimasa, memilih item menu Bagikan, dan memilih kontak Anda.
5. Mirror API membuat salinan kartu linimasa bersama, memberi kontak Anda akses ke salinan tersebut, dan menyisipkan salinan tersebut ke linimasa pengguna. Glassware Anda tidak dapat mengakses item linimasa yang asli.
6. Jika Anda berlangganan untuk membagikan notifikasi, Anda menerima payload yang berisi informasi pengidentifikasi kartu linimasa. Anda kemudian dapat mengambil item {i>timeline<i} dengan Timeline.get.
7. Anda akan mengubah kartu linimasa bersama dan memperbarui kartu linimasa yang ada dengan Timeline.update.

Kapan menggunakannya

Secara {i>default<i}, Glassware tidak dapat mengakses item linimasa yang tidak dibuatnya, jadi kontak mengizinkan Glassware untuk berbagi data Glassware dengan persetujuan pengguna.

Ada dua cara utama Glassware Anda dapat menggunakan kontak:

• Izinkan pengguna membagikan item linimasa Anda kepada kontak lain: Tambahkan Item menu bawaan SHARE ke kartu linimasa. Saat pengguna mengetuk item menu berbagi, Glass akan menampilkan daftar kontak yang mungkin untuk diajak berbagi.

• Izinkan pengguna berbagi item linimasa dengan Glassware Anda: Buat kontak yang mewakili Gelas Anda. Saat pengguna ingin berbagi kartu linimasa, kontak muncul sebagai opsi. Anda juga dapat mendeklarasikan daftar jenis MIME yang dapat diterima sehingga kontak hanya muncul untuk kartu yang Anda minati. Untuk mendapatkan notifikasi saat pengguna membagikan kartu linimasa kepada kontak Anda, Anda dapat berlangganan notifikasi linimasa.

Membuat kontak

Untuk memungkinkan pengguna berbagi item linimasa dengan Glassware Anda, masukkan kontak dengan MEMPOSTING Representasi JSON kontak untuk masukkan endpoint REST.

Semua kontak harus menentukan id, yang mengidentifikasi kontak ke Glassware menerima notifikasi. Anda juga harus menentukan displayName dan minimal satu imageUrls, yang digunakan Glass untuk menampilkan informasi kontak kepada pengguna.

Catatan: Untuk hasil terbaik, gunakan gambar ikon PNG berukuran 640 x 360 piksel dengan latar belakang transparan untuk imageUrls.

HTTP Mentah

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
}

Berlangganan notifikasi berbagi

Mirror API memungkinkan Anda untuk berlangganan notifikasi yang dikirim saat pengguna melakukan tindakan tertentu pada Item Linimasa atau kapan lokasi pengguna telah diperbarui. Jika berlangganan notifikasi, Anda menyediakan URL callback yang memproses notifikasi.

Catatan: Dalam produksi, URL callback harus mendukung SSL. Untuk tujuan pengembangan, kami menyediakan server proxy langganan yang dapat meneruskan notifikasi ke server pengembangan non-SSL Anda.

Notifikasi dari Mirror API dikirim sebagai permintaan POST ke endpoint langganan yang berisi isi permintaan JSON.

HTTP Mentah

{
  "collection": "timeline",
  "itemId": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
  "operation": "INSERT",
  "userToken": "harold_penguin",
  "verifyToken": "random_hash_to_verify_referer",
  "userActions": [
    {
      "type": "SHARE"
    }
  ]
}

Atribut itemId adalah ID item linimasa bersama, yang dapat Anda gunakan dengan Timeline.get untuk mendapatkan item linimasa. Contoh berikut menunjukkan item linimasa standar dengan lampiran foto:

{
  "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>"
          ]
      }
  ]
}

Layanan Anda harus merespons API dengan status HTTP 200 OK jika tidak terjadi error. Jika layanan Anda merespons dengan kode error, Mirror API mungkin coba kirim ulang notifikasi ke layanan Anda.

Catatan: Waktu koneksi akan habis setelah 10 detik. Jika proses yang panjang diperlukan, segera tanggapi, dan lakukan proses di thread lain.

Menerima transkripsi ucapan

Pengguna dapat membagikan ucapan yang ditranskripsikan kepada kontak Anda melalui menu suara utama. Saat ini ada dua perintah suara yang dapat digunakan kontak Anda:

• "buat catatan"
• "posting pembaruan"

Misalnya, pengguna dapat memberi tahu kita tentang Chipotle's ulang tahun yang akan datang dengan frasa: "Ok Glass... posting pembaruan ke... Streaming Kucing... Ulang tahun Chipotle besok!"

Untuk menggunakan perintah suara:

1. Tentukan acceptCommands dengan properti type:

   {
     ...
   
     "displayName": "Cat Stream",
     "id": "CAT_STREAM",
     "acceptCommands": [
       {"type": "POST_AN_UPDATE"}
     ]
   }
   

2. Berlangganan notifikasi linimasa untuk diberi tahu bahwa ucapan yang ditranskripsi tersedia. Gelas Anda menerima notifikasi saat hal ini terjadi:

   {
     "collection": "timeline",
     "operation": "UPDATE",
     "userToken": "<USER_TOKEN>",
     "verifyToken": "<VERIFY_TOKEN>",
     "itemId": "<ITEM_ID>",
     "userActions": [
       {"type": "LAUNCH"}
     ]
   }
   

3. Gunakan itemId untuk mengambil item linimasa:

   {
     "id": "<ITEM_ID>",
     "text": "Chipotle's birthday is tomorrow",
     "recipients": [
       {"id": "CAT_STREAM"}
     ]
   }
   

   Catatan: Saat menerima item linimasa yang dibagikan, memperbarui kartu linimasa yang ada dengan Timeline.update daripada membuat yang baru jika Anda memodifikasi item.

4. Jika lebih dari satu Glassware mendaftarkan kontak dengan perintah suara yang sama, Glass menampilkan menu tingkat kedua yang menunjukkan displayName dari setiap kontak. Kemudian, pengguna dapat mengucapkan kontak pilihan mereka. Jika kode displayName berisi karakter yang tidak dapat diucapkan atau tidak fonetik, gunakan Properti speakableName untuk menyatakan pengucapan yang diharapkan dari kontak berbagi Anda.

Teks untuk foto yang dibagikan

Pengguna memiliki kemampuan untuk berbagi foto dengan Glassware Anda dengan teks yang mereka masukkan dengan ucapan. Alur pengguna umumnya adalah:

1. Pengguna mengetuk item linimasa yang berisi foto, lalu memilih Bagikan item menu, dan memilih kontak Anda.
2. Pengguna mengetuk lagi dalam waktu singkat untuk menambahkan teks ke foto tersebut.
3. Pengguna mengucapkan teks.
4. Item linimasa dibagikan dengan Glassware Anda seperti yang dijelaskan sebelumnya di Cara kerjanya. Selain itu, properti text item linimasa adalah disetel dengan teks yang ditranskripsikan pengguna.