Kişiler

Kişiler, Glassware'inizin kendi oluşturmadığı zaman çizelgesi öğelerini almasına izin verir. Kullanıcılar, bir kartın Paylaş menü öğesine dokunarak zaman çizelgesi öğesini ilgili kişiyle açıkça paylaşmalıdır.

İş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. Bildirimleri paylaşmak için abone olduysanız zaman çizelgesi kartının tanımlayıcı bilgilerini içeren bir yük alırsınız. Daha sonra Timeline.get ile zaman çizelgesi öğesini alabilirsiniz.
7. Paylaşılan zaman çizelgesi kartını değiştirir ve mevcut zaman çizelgesi kartını Timeline.update ile güncellersiniz.

Ne zaman kullanılır?

Varsayılan olarak, Glassware kendi oluşturmadığı zaman çizelgesi öğelerine erişemez. Bu nedenle kişiler, kullanıcının izniyle Glassware'den Glassware 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 verin: Zaman çizelgesi kartına SHARE yerleşik menü öğesini ekleyin. Kullanıcılar paylaş menü öğesine dokunduğunda Glass, paylaşımda bulunabilecek kişilerin bir listesini görüntüler.

• Kullanıcıların zaman çizelgesi öğelerini Glassware'inizle paylaşmasına izin verin: Glassware uygulamanızı temsil eden bir kişi oluşturun. Kullanıcılar zaman çizelgesi kartı paylaşmak istediğinde kişileriniz bir seçenek olarak görünür. Ayrıca, kişinizin yalnızca ilgilendiğiniz kartlarda görünmesi için kabul edilebilir MIME türlerinin bir listesini de bildirebilirsiniz. Kullanıcılar kişinizle zaman çizelgesi kartı paylaştığında bildirim almak için zaman çizelgesi bildirimlerine abone olabilirsiniz.

Kişi oluşturma

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

Tüm kişilerin, bildirimleri alan Glassware'e kişiyi tanımlayan bir id belirtmesi gerekir. Ayrıca, Glass'ın iletişim bilgilerini kullanıcıya görüntülemek için kullandığı bir displayName ve en az bir imageUrls belirtmeniz gerekir.

Not: En iyi sonuçlar için imageUrls için şeffaf arka plana sahip 640 x 360 piksellik bir PNG simge resmi kullanın.

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, kullanıcı bir Zaman Çizelgesi Öğesi'nde belirli işlemler gerçekleştirdiğinde veya kullanıcı konumu güncellendiğinde gönderilen bildirimlere abone olmanıza olanak tanır. Bir bildirime abone olduğunuzda, bildirimi işleyen bir geri çağırma URL'si sağlarsınız.

Not: Üretimde geri çağırma URL'nizin SSL'yi desteklemesi gerekir. Geliştirme amacıyla, bildirimleri SSL olmayan geliştirme sunucunuza iletebilen bir abonelik proxy sunucusu sağlıyoruz.

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

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. Zaman çizelgesi öğesini almak için Timeline.get ile bu özelliği kullanabilirsiniz. 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>"
          ]
      }
  ]
}

Hata oluşmadıysa hizmetiniz 200 OK HTTP durum koduyla API'ye yanıt vermelidir. Hizmetiniz bir hata koduyla yanıt verirse Mirror API, bildirimi hizmetinize yeniden göndermeyi deneyebilir.

Not: Bağlantı 10 saniye sonra zaman aşımına uğrar. Uzun bir işlem gerekiyorsa 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ı Chipotle'ın yaklaşan doğum gününü bize şu cümleyle bildirebilir: "Ok Glass... bir güncelleme yayınla... Kedi Akışı... Chipotle'ın doğum günü yarın!"

Sesli komutları kullanmak için:

1. acceptCommands özelliğini uygun type ile belirtin:

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

2. Metne dönüştürülen konuşmanın kullanılabilir olduğuyla ilgili bildirim almak için zaman çizelgesi bildirimlerine abone olun. Böyle bir durumda Glassware'iniz bir bildirim alır:

   {
     "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, öğeyi değiştiriyorsanız yeni bir tane oluşturmak yerine mevcut zaman çizelgesi kartını Timeline.update ile güncelleyin.

4. Birden fazla Glassware aynı sesli komutla bir kişiyi kaydederse Glass her kişinin displayName bilgisini gösteren ikinci düzey bir menü görüntüler. Böylece kullanıcılar istedikleri kişiyle konuşabilir. Kişinin displayName etiketi telaffuz edilemeyen karakterler içeriyorsa veya fonetik değilse paylaşım kişinizin beklenen telaffuzunu beyan etmek için speakableName özelliğini kullanın.

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

Kullanıcılar, fotoğrafları sesli okudukları altyazılarla birlikte Glassware'inizle paylaşabilirler. Genel kullanıcı işlemleri akışı şöyledir:

1. Kullanıcı fotoğraf içeren bir zaman çizelgesi öğesine dokunur, Paylaş menü öğesini seçer ve kişinizi seçer.
2. Kullanıcı, fotoğrafa başlık eklemek için kısa bir süre içinde tekrar dokunur.
3. Kullanıcı bir altyazı okur.
4. Zaman çizelgesi öğesi, daha önce İşleyiş şekli bölümünde açıklandığı gibi Glassware'inizle paylaşılır. Buna ek olarak zaman çizelgesi öğesinin text özelliği, kullanıcının metne dönüştürülen altyazısına göre ayarlanır.