Kişiler

Kişiler, Glassware'inizin kendi oluşturmadığı zaman çizelgesi öğelerini almasına izin verir. Kullanıcılar bir kartın Paylaş menü öğesi.

İşleyiş şekli

Paylaşımda bulunulan bir kişi oluşturulduktan sonra, zaman çizelgesi kartları paylaşılırken şu genel akış izlenir:

1. Bir kişi oluşturun ve kişinin desteklediği MIME türlerini tanımlayın.
2. Kişiyi kullanıcınızın zaman çizelgesine ekleyin.
3. Kullanıcı, Paylaş menü öğesi olan bir zaman çizelgesi öğesi alır. Cam yazılımları, kullanıcıların öğelerini bu menü öğesiyle paylaşmasına açıkça izin vermelidir.
4. Kullanıcı zaman çizelgesi öğesine dokunur, Paylaş menü öğesini seçer ve kişinizi seçer.
5. Mirror API paylaşılan zaman çizelgesi kartının bir kopyasını oluşturur, iletişim kişinize kopya için erişim izni verir ve kopyayı kullanıcının zaman çizelgesine ekler. Glassware'iniz orijinal zaman çizelgesi öğesine erişemiyor.
6. Şu durumda: bildirim paylaşmak için abone olan, zaman çizelgesi kartının tanımlayıcı bilgilerini içeren bir yük alırsınız. Daha sonra zaman çizelgesi öğesini Timeline.get olarak ayarlayın.
7. Paylaşılan zaman çizelgesi kartını değiştirir ve mevcut zaman çizelgesi kartını güncellersiniz Timeline.update ile güncelleyin.

Ne zaman kullanılır?

Varsayılan olarak, Glassware kendi oluşturmadığı zaman çizelgesi öğelerine erişemez. Böylece kişiler, kullanıcının izniyle Glassware'den Glassware'e veri paylaşımına izin verirler.

Glassware'inizin kişileri kullanabileceği iki ana yol vardır:

• Kullanıcıların zaman çizelgesi öğelerinizi diğer kişilerle paylaşmasına izin verme: SHARE yerleşik menü öğesi bir karta ekleyin. Kullanıcılar paylaş menü öğesine dokunduğunda Glass bir liste görüntüler kadar kişiyle paylaşabilirsiniz.

• Kullanıcıların zaman çizelgesi öğelerini Glassware'inizle paylaşmasına izin ver: Kişi oluşturun gösteren bir resim görürsünüz. Kullanıcılar bir zaman çizelgesi kartını paylaşmak istediğinde seçeneği gösterilir. Ayrıca genel hatlarıyla kabul edilebilir MIME türleri Böylece kişiniz, yalnızca ilgilendiğiniz kartlarda görünür. Kullanıcılar kişinizle zaman çizelgesi kartı paylaştığında bildirim almak için şunları yapabilirsiniz: Zaman çizelgesi bildirimlerine abone olun.

Kişi oluşturma

Kullanıcıların zaman çizelgesi öğelerini Glassware'inizle paylaşmasına izin vermek için bir kişi için Bir kişinin JSON gösterimi REST uç noktası ekleyin.

Tüm kişilerin, kişiyi Glassware'e tanımlayan bir id belirtmesi gerekir bildirimleri alıyor. Ayrıca, displayName ve en az bir imageUrls ( Glass bu verileri görüntülemek için kullanır) kullanıcıya gönderilir.

Not: En iyi sonuçlar için 640 x 360 piksel boyutunda ve yüksek çözünürlüklü bir PNG simge resmi kullanın. imageUrls için şeffaf bir arka plan.

Ham 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
}

Paylaşım bildirimlerine abone olma

Mirror API ile yapabilecekleriniz bildirimlere abone ol Kullanıcı bir web sitesinde belirli işlemler yaptığında Zaman çizelgesi öğesi veya kullanıcının konumu güncellendi. Bir bildirime abone olduğunuzda bildirimi işleyen bir geri çağırma URL'si sağlamalıdır.

Not: Üretimde geri çağırma URL'nizin SSL'yi desteklemesi gerekir. Geliştirme amacıyla yönlendirme yapabilen abonelik proxy sunucusu SSL olmayan geliştirme sunucunuza bildirim gönderme.

Mirror API'den gelen bir bildirim, POST isteği olarak JSON istek gövdesi içeren abone olunan uç nokta.

Ham HTTP

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

itemId özelliği, paylaşılan zaman çizelgesi öğesinin ID değeridir. Bu özelliği kullanabilirsiniz Timeline.get ile kaydedin. Aşağıdaki örnekte, fotoğraf eki içeren tipik bir zaman çizelgesi öğesi gösterilmektedir:

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

Hizmetiniz API'ye 200 OK HTTP durumuyla yanıt vermelidir kodunu girmeniz gerekir. Hizmetiniz bir hata koduyla yanıt veriyorsa Mirror API'si bildirimi hizmetinize yeniden göndermeyi deneyin.

Not: Bağlantı 10 saniye sonra zaman aşımına uğrar. Uzun bir süreç gerekliyse hemen yanıt verin ve işlemi başka bir ileti dizisinde yapın.

Konuşma transkripti alınıyor

Kullanıcılar, metne dönüştürülen konuşmayı ana ses menüsünü kullanarak kişilerinizle paylaşabilir. Şu anda kişinizin kullanabileceği iki sesli komut vardır:

• "not al"
• "güncelleme yayınla"

Örneğin, bir kullanıcı bize Chipotle'ın şu cümleyle yaklaşan doğum günü: "Ok Glass... şunu güncelle: Kedi Akışı... Chipotle'ın doğum günü yarın!"

Sesli komutları kullanmak için:

1. Belirtin: acceptCommands ve type:

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

2. Zaman çizelgesi bildirimlerine abone ol yazıya dökülen konuşmanın mevcut olduğu konusunda bilgilendirileceksiniz. Bardağınız şu durumda bir bildirim alırsınız:

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

3. Zaman çizelgesi öğesini getirmek için itemId işlevini kullanın:

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

   Not: Paylaşılan zaman çizelgesi öğesini aldığınızda mevcut zaman çizelgesi kartını Timeline.update yerine yeni bir öğe oluşturun.

4. Birden fazla Glassware aynı sesli komutla bir kişiyi kaydederse Glass, şurayı gösteren ikinci düzey bir menü gösterir: Her kişinin displayName. Böylece kullanıcılar istedikleri kişiyle konuşabilir. Kişinin displayName şunu içerir: harf ve fonetik olmayan karakterler içeriyorsa speakableName mülkü ifadesini girin.

Paylaşılan fotoğraflar için başlıklar

Kullanıcılar, Bardaklı fotoğraflarda fotoğraf paylaşma imkanına sahip konuşmayla girdikleri bir metin altyazısı da kullanabilirsiniz. Genel kullanıcı işlemleri akışı şöyledir:

1. Kullanıcı fotoğraf içeren bir zaman çizelgesi öğesine dokunup Paylaş'ı seçer ve kişinizi seçer.
2. Kullanıcı kısa bir süre içinde fotoğraf.
3. Kullanıcı bir altyazı okur.
4. Zaman çizelgesi öğesi, daha önce şurada açıklandığı gibi Glassware'inizle paylaşılır: İşleyiş şekli. Ayrıca, zaman çizelgesi öğesinin text özelliği kullanıcının konuşma metnine ayarlanır.