Sohbet İşlemleri, 13 Haziran 2023'te kullanımdan kaldırılacak. Daha fazla bilgi için Görüşme İşlemleri'nin kullanımdan kaldırılması başlıklı makaleyi inceleyin.

Etkileşimli Tuval

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Şekil 1. Etkileşimli Tuval kullanılarak oluşturulan etkileşimli oyun.

Etkileşimli Tuval, geliştiricilerin Görüşme İşlemlerine görsel, sürükleyici deneyimler eklemesine olanak tanıyan, Google Asistan üzerine kurulmuş bir çerçevedir. Bu görsel deneyim, Asistan'ın görüşmede kullanıcıya yanıt olarak gönderdiği etkileşimli bir web uygulamasıdır. Bir Asistan görüşmesinde satır içi olarak bulunan zengin yanıtların aksine, Etkileşimli Tuval web uygulaması tam ekran web görünümü olarak oluşturulur.

İşleminizde aşağıdakilerden birini yapmak istiyorsanız Etkileşimli Tuval özelliğini kullanın:

  • Tam ekran görseller oluşturma
  • Özel animasyonlar ve geçişler oluşturma
  • Veri görselleştirme işlemi yapın
  • Özel düzenler ve GUI'ler oluşturma

Desteklenen cihazlar

Etkileşimli Tuval şu anda aşağıdaki cihazlarda kullanılabilmektedir:

  • Akıllı ekranlar
  • Android mobil cihazlar

Nasıl çalışır?

Etkileşimli Tuval kullanan bir işlemin iki ana bileşeni vardır:

  • Konuşma İşlemi: Kullanıcı isteklerini gerçekleştirmek için konuşma arayüzü kullanan bir işlem. Görüşmenizi oluşturmak için Actions Builder veya Actions SDK'yı kullanabilirsiniz.
  • Web uygulaması: İşleminizin görüşme sırasında kullanıcılara yanıt olarak gönderdiği özelleştirilmiş görsellere sahip bir kullanıcı arabirimi web uygulaması. Web uygulamasını HTML, JavaScript ve CSS gibi web teknolojileriyle oluşturursunuz.

Etkileşimli bir Canvas Action ile etkileşimde bulunan kullanıcılar, hedeflerine ulaşmak için Google Asistan'la karşılıklı sohbet ediyor. Ancak Etkileşimli Tuval için bu görüşmenin büyük kısmı web uygulamanızın bağlamında gerçekleşir. Görüşme İşleminizi web uygulamanıza bağlarken web uygulaması kodunuza Interactive Canvas API'yi eklemeniz gerekir.

  • Etkileşimli Tuval kitaplığı: Bir API kullanarak web uygulaması ile Görüşme İşleminiz arasında iletişim sağlamak için web uygulamasına eklediğiniz bir JavaScript kitaplığıdır. Daha fazla bilgi için Interactive Canvas API dokümanlarına bakın.

Etkileşimli uygulamanızı Canvas'a eklemenin yanı sıra, web uygulamanızı kullanıcının cihazında açmak için görüşmenizde Canvas yanıt türünü döndürmeniz gerekir. Ayrıca, web uygulamanızı kullanıcının girişine göre güncellemek için bir Canvas yanıtı da kullanabilirsiniz.

  • Canvas: Web uygulamasının URL'sini ve iletilecek verileri içeren bir yanıttır. Actions Builder, Canvas uygulamasını eşleşen niyet ve geçerli sahne verileriyle otomatik olarak doldurarak web uygulamasını güncelleyebilir. Alternatif olarak, Node.js istek karşılama kitaplığını kullanarak webhook'tan Canvas yanıtı gönderebilirsiniz. Daha fazla bilgi için Tuval istemleri konusuna bakın.

Etkileşimli Tuval'in nasıl çalıştığını göstermek için cihaz ekranının rengini kullanıcının belirlediği bir renge dönüştüren Cool Colors adında bir işlem olduğunu varsayalım. Kullanıcı İşlemi çağırdıktan sonra şu akış gerçekleşir:

  1. Kullanıcı, Asistan cihazına "Ekranı mavi yap" diyor.
  2. Actions on Google platformu, kullanıcının isteğini belirli bir amaç doğrultusunda eşleştirmek için konuşma mantığınıza yönlendirir.
  3. Platform, amacı İşlem'in sahnesiyle eşleştirir. Böylece, bir etkinlik tetiklenir ve cihaza Canvas yanıtı gönderilir. Cihaz, yanıtta sağlanan URL'yi kullanarak (henüz yüklenmediyse) bir web uygulaması yükler.
  4. Web uygulaması yüklendiğinde, geri çağırmaları Interactive Canvas API ile kaydeder. Tuval yanıtı bir data alanı içeriyorsa data alanının nesne değeri, web uygulamasının kayıtlı onUpdate geri çağırmasına iletilir. Bu örnekte, konuşma mantığı, veri alanı blue olan bir değişken içeren Canvas yanıtı gönderir.
  5. Canvas yanıtının data değerini aldıktan sonra onUpdate geri çağırması, web uygulamanız için özel mantık yürütebilir ve tanımlanan değişiklikleri yapabilir. Bu örnekte, onUpdate geri çağırması data içindeki rengi okur ve ekranı maviye çevirir.

İstemci tarafı ve sunucu tarafı sipariş karşılama

Etkileşimli Tuval İşlemi oluştururken iki sipariş karşılama uygulaması yolunu seçebilirsiniz: sunucu sipariş karşılama veya istemci sipariş karşılama. Sunucu karşılamayla, öncelikli olarak webhook gerektiren API'leri kullanırsınız. İstemci karşılama ile istemci taraflı API'leri ve gerekirse Canvas dışı özellikler (hesap bağlama gibi) için webhook gerektiren API'leri kullanabilirsiniz.

Proje oluşturma aşamasında sunucu webhook'u karşılama özelliğiyle derleme yapmayı seçerseniz web uygulamasını güncellemek ve ikisi arasındaki iletişimi yönetmek için konuşma mantığı ve istemci tarafı JavaScript'i işleyecek bir webhook dağıtmanız gerekir.

Derlemeyi istek karşılama ile (şu anda Geliştirici Önizlemesi olarak sunulmaktadır) yapmayı tercih ederseniz, Action'ın mantığını özel olarak sadece web uygulamasında oluşturmak için yeni istemci taraflı API'ler kullanabilirsiniz. Bu özellik, geliştirme deneyimini basitleştirir, konuşma dönüşleri arasındaki gecikmeyi azaltır ve cihaz içi özellikleri kullanmanızı sağlar. Gerekirse istemciden sunucu tarafı mantığına da geçebilirsiniz.

İstemci tarafı özellikleri hakkında daha fazla bilgi için İstemci tarafı siparişle derleme bölümüne bakın.

Sonraki adımlar

Etkileşimli Tuval için nasıl web uygulaması oluşturacağınızı öğrenmek üzere Web uygulamaları konusuna bakın.

Etkileşimli Tuval İşlemi'nin tam kodunu görmek için GitHub'daki örneğe bakın.