Kontak

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

Cara kerjanya

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

1. Buat kontak dan tentukan jenis MIME yang didukung kontak Anda.
2. Sisipkan kontak ke linimasa pengguna Anda.
3. Pengguna menerima item linimasa yang memiliki item menu Bagikan. Glassware harus secara eksplisit mengizinkan pengguna membagikan 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, memberikan akses ke salinan tersebut kepada kontak Anda, dan menyisipkan salinan ke linimasa pengguna. Glassware Anda tidak dapat mengakses item linimasa asli.
6. Jika Anda berlangganan notifikasi berbagi, Anda akan menerima payload yang berisi informasi identifikasi kartu linimasa. Kemudian, Anda dapat mengambil item linimasa dengan Timeline.get.
7. Anda mengubah kartu linimasa bersama dan memperbarui kartu linimasa yang ada dengan Timeline.update.

Kapan menggunakannya

Secara default, Glassware tidak dapat mengakses item linimasa yang tidak dibuatnya, sehingga kontak memungkinkan Glassware berbagi data Glassware dengan izin pengguna.

Ada dua cara utama Glassware Anda dapat menggunakan kontak:

• Mengizinkan pengguna membagikan item linimasa Anda dengan kontak lain: Tambahkan item menu bawaan SHARE ke kartu linimasa. Saat pengguna mengetuk item menu berbagi, Glass akan menampilkan daftar kemungkinan kontak yang dapat dibagikan.

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

Membuat kontak

Untuk mengizinkan pengguna membagikan item linimasa dengan Glassware Anda, sisipkan kontak dengan memposting representasi JSON kontak ke endpoint REST penyisipan.

Semua kontak harus menentukan id, yang mengidentifikasi kontak ke Glassware yang menerima notifikasi. Anda juga harus menentukan displayName dan setidaknya 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 saat lokasi pengguna telah diperbarui. Saat berlangganan notifikasi, Anda akan memberikan URL callback yang memproses notifikasi.

Catatan: Dalam produksi, URL callback Anda 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 yang berlangganan 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 umum 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 kode status HTTP 200 OK jika tidak terjadi error. Jika layanan Anda merespons dengan kode error, Mirror API mungkin akan mencoba mengirim ulang notifikasi ke layanan Anda.

Catatan: Koneksi akan habis waktunya setelah 10 detik. Jika proses yang panjang diperlukan, segera respons dan lakukan proses di thread lain.

Menerima transkripsi ucapan

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

• "buat catatan"
• "posting update"

Misalnya, pengguna dapat memberi tahu kami tentang ulang tahun Chipotle yang akan datang dengan frasa: "Ok Glass... posting update ke... Cat Stream... Ulang tahun Chipotle besok!"

Untuk menggunakan perintah suara:

1. Tentukan properti acceptCommands dengan yang sesuai type:

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

2. Berlangganan notifikasi linimasa untuk mendapatkan notifikasi bahwa ucapan yang ditranskripsikan tersedia. Glassware Anda akan 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 Anda menerima item linimasa bersama, perbarui kartu linimasa yang ada dengan Timeline.update bukan membuat kartu baru jika Anda mengubah item.

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

Teks untuk foto bersama

Pengguna dapat membagikan foto dengan Glassware Anda dengan teks pendamping yang mereka masukkan dengan ucapan. Alur pengguna umum adalah:

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