
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'tanCanvas
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:
- Kullanıcı, Asistan cihazına "Ekranı mavi yap" diyor.
- 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.
- 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. - Web uygulaması yüklendiğinde, geri çağırmaları Interactive Canvas API ile kaydeder.
Tuval yanıtı bir
data
alanı içeriyorsadata
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çerenCanvas
yanıtı gönderir. Canvas
yanıtınındata
değerini aldıktan sonraonUpdate
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.