Eklenti işlemleri

Eklenti işlemleri, widgets'a ekleyin. Bir işlem oluşturarak, kullanıcı seçtiğinde veya güncellediğinde ne olacağını tanımlarsınız widget'a dokunun.

Çoğu durumda, eklenti işlemlerini tanımlamak için Action Apps Komut Dosyası Kart hizmeti tarafından sağlanan nesneler. Her Action şununla ilişkilidir: bir geri çağırma işlevi oluşturduğunuzda. Geri çağırma işlevini kullanıcı widget'la etkileşimde bulunduğunda istenen adımları atın. Ayrıca Action öğesini widget'a bağla widget'ın doğru bir widget işleyici işlevi ne tür etkileşimin tetiklediğini Action geri çağırma.

Widget'ı Action ile yapılandırma şu genel süreci kullanarak:

  1. Action nesnesini oluşturun. geri çağırma işlevini belirtmesi gerekli tüm parametrelerle birlikte yürütülür.
  2. Uygun widget işleyici işlevini çağırma Action kullanarak widget'ta nesnesini tanımlayın.
  3. Gerekli davranışı uygulamak için geri çağırma işlevini uygulayın.
ziyaret edin.

Widget işleyici işlevleri

Bir widget'ı belirli bir Action'e bağlamak için veya başka bir davranış, widget'lar ile işleyici fonksiyonudur. İşleyici işlevi, ne tür bir etkileşimin (örneğin, widget'ı tıkladığınızda veya bir metin alanını düzenlediğinizde) eylem davranışına dayalıdır. İşleyici işlevi ayrıca, kullanıcı arayüzünün hangi adımları (ör. işlem tamamlandıktan sonra)

Aşağıdaki tabloda, widget'lar için farklı işleyici türleri ve widget'ları şunlardır:

İşleyici işlevi İşlemi tetikler Geçerli widget'lar Açıklama
setOnChangeAction() Widget değeri değişir DatePicker
DateTimePicker
SelectionInput
Switch
TextInput TimePicker
Action ayarlar odağını kaybettiğinde (örneğin, Kullanıcı bir girişe metin girip Enter tuşuna bastığında buna örnek gösterilebilir. İlgili içeriği oluşturmak için kullanılan işleyicisi otomatik olarak bir event nesnesini çağırdığı işleve ekleyin. Bu etkinlik nesnesine ek parametre bilgileri ekleyebilirsiniz tercih edebilirsiniz.
setOnClickAction() Kullanıcı widget'ı tıklar CardAction
Image
ImageButton
DecoratedText
TextButton
Action ayarlar kullanıcı widget'ı tıkladığında Apps Komut Dosyası işlevi yürüten bir uygulamadır. İlgili içeriği oluşturmak için kullanılan işleyicisi otomatik olarak bir event nesnesini çağırdığı işleve ekleyin. Bu etkinlik nesnesine isteğe bağlı parametre bilgileri ekleyebilirsiniz.
setComposeAction() Kullanıcı widget'ı tıklar CardAction
Image
ImageButton
DecoratedText
TextButton
Gmail'e özel. Bir Action. e-posta taslağı oluşturan ve ardından bu taslağı kullanıcıya bir Gmail kullanıcı arayüzü oluşturma penceresi. Taslağı yeni bir mesaj veya Gmail'de açık olan iletiyi yanıtlayabilir. İşleyici taslak oluşturma geri çağırma işleviyle, event nesnesini geri çağırma işlevine ekleyin. Görüntüleyin Taslak iletiler oluşturma inceleyebilirsiniz.
setOnClickOpenLinkAction() Kullanıcı widget'ı tıklar CardAction
Image
ImageButton
DecoratedText
TextButton
Action ayarlar tıklayın. Aşağıdaki işlemleri yaparken bu işleyiciyi kullanın: URL'yi oluşturmalı veya bağlantıdan önce başka işlemler yapılmalıdır. açılış sayfası; Aksi takdirde setOpenLink() kullanımı genellikle daha basit olur. URL'yi yalnızca yeni bir pencerede açabilirsiniz. Kapalı olduğunda, Kullanıcı arayüzünü tıklayın.
setOpenLink() Kullanıcı widget'ı tıklar CardAction
Image
ImageButton
DecoratedText
TextButton
Kullanıcı widget'ı tıkladığında doğrudan bir URL açar. Bunu kullan işleyicisini; URL'yi biliyorsanız ve yalnızca açmanız gerekiyorsa; aksi takdirde kullanın setOnClickOpenLinkAction() URL'yi yeni bir pencerede veya yer paylaşımında açabilirsiniz. Kapalı olduğunda kullanıcı arayüzünün eklentiyi yeniden yüklemesine neden olabilir.
setSuggestionsAction() Kullanıcı bir girişe metin girer TextInput Action ayarlar kullanıcı bir dosyaya metin girdiğinde Apps Komut Dosyası işlevini yürüten metin girişi widget'ı. İşleyici otomatik olarak bir event nesnesini çağırdığı işleve ekleyin. Görüntüleyin Otomatik tamamlama önerileri hakkında daha fazla bilgi edinin.

Geri çağırma işlevleri

Geri çağırma işlevleri, bir Action tetikleyiciler için geçerlidir. Geri çağırma işlevi Apps Komut Dosyası işlevleri olduğundan bunları diğer komut dosyası işlevlerinin yapabileceği neredeyse her şeyi yapabilir.

Bir geri çağırma işlevi bazen belirli bir yanıt nesnesini döndürür. Bu Bir sonraki aşamaya geçmeden önce gerçekleştirmeniz gereken ek geri çağırmanın yürütülmesi, örneğin yeni bir kart gösterme veya sunum yapma Otomatik tamamlama önerileri. Geri çağırma işlevinizin belirli bir yanıt nesnesinde, Kart hizmetinde bir oluşturucu sınıfı kullanırsınız. oluşturmaya karar veriyor.

Aşağıdaki tabloda, geri çağırma işlevlerinizin ne zaman belirli bir yanıt nesnesini kullanın. Bu işlemlerin hepsi Eklentinin kapsamını genişlettiği belirli ana makine uygulamasından bağımsız olarak:

Yapılmak istenen işlem Geri çağırma işlevi şunu döndürmelidir:
Kartlar arasında gezinme ActionResponse
Notification gösterin ActionResponse
Bir bağlantıyı setOnClickOpenLinkAction() kullanarak açın ActionResponse
Otomatik tamamlama önerilerini görüntüleme SuggestionResponse
Genel işlem kullanma UniversalActionResponse
Diğer işlemler Nothing

Bu işlemlere ek olarak her ana makine uygulamasının kendi yalnızca bu ana makinede yapılabilecek işlemlerdir. Ayrıntılar için aşağıdakilere göz atın kılavuzlar:

ziyaret edin.

İşlem etkinliği nesneleri

Eklentiniz bir Action tetiklediğinde Kullanıcı arayüzü otomatik olarak bir JSON etkinlik nesnesi oluşturur ve bunu Action geri çağırma bağımsız değişkeni işlevini kullanın. Bu etkinlik nesnesi, kullanıcının şu andaki durumuyla ilgili bilgiler içeriyor tüm etkileşimli yapılandırmaların geçerli değerleri gibi widget'ları görebilirsiniz.

İşlem etkinliği nesnelerinin en iyi yoludur. Aynı yapı, bir sorguda ana sayfa tetikleyicisi bir ana sayfa oluşturmak için tetiklendiğinde veya bir içeriğe dayalı tetikleyici etkinleşir.

Tam etkinlik için Etkinlik nesnelerini inceleyin açıklamaya bakın.