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:
Actionnesnesini oluşturun. geri çağırma işlevini belirtmesi gerekli tüm parametrelerle birlikte yürütülür.- Uygun widget işleyici işlevini çağırma
Actionkullanarak widget'ta nesnesini tanımlayın. - Gerekli davranışı uygulamak için geri çağırma işlevini uygulayın.
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 |
DatePickerDateTimePickerSelectionInputSwitchTextInput
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 |
CardActionImageImageButtonDecoratedTextTextButton
|
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 |
CardActionImageImageButtonDecoratedTextTextButton
|
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 |
CardActionImageImageButtonDecoratedTextTextButton
|
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 |
CardActionImageImageButtonDecoratedTextTextButton
|
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.