ReferansBileşenler

quick_replies

En fazla altı öneri çipi. Her dokunma bir yanıt gönderir.

Yazılmak yerine sunulan, bir sonraki söylenecek ifade. quick_replies, bir yanıtın sonunu iki veya üç dokunmaya dönüştürür: bu yanıtın genellikle ortaya çıkardığı takip soruları, kullanıcının kendi kelimeleriyle sunulur.

Bir sohbeti akıcı tutmanın en az maliyetli yoludur ve bir asistanın, tersi yerine uygulamayı gerçekten tanıdığı hissini vermesinin en yaygın nedenidir.

Blok bir title içerdiğinde veya herhangi bir yanıt bir icon değerine sahip olduğunda, yanıtlar kart olarak çizilir; her biri emojisi veya ikonu ve bir ok içeren tam bir sorudur: yanıt sayfasının alt kısmında, devam etme yolu. Düz yanıtlar (“Evet”, “Hayır”) hap biçiminde kalır.

1042 numaralı siparişi takip etBeden tablosuİade başlat

Ekran görüntüsü değildir; tarayıcınızda SDK'nın kendi boyut ve renkleriyle canlı olarak çizilir.

Flutter SDK ve Web SDK ile, her ikisi de 0.1.0 sürümünden itibaren yerel olarak render edilir.

Ne zaman kullanılmamalı

Bir değer toplamak için çipleri kullanmayın: birkaç seçenek arasından tek seçim choice, birden fazla alan ise form bileşenidir.

Saat seçmek için de bunları kullanmayın: saatlerin güne göre gruplanması ve arkalarında bir rezervasyon akışı bulunması gerekir; bu da datetime_slots bileşenidir. Bir yazma işlemini onaylamak için de bunları kullanmayın: onaylama işlemi, modelin neyin onaylandığını yanlış ifade edememesi için sunucunun oluşturduğu confirm_card bileşenidir.

Props

Her blok ayrıca type ve 1 ila 300 karakterden oluşan zorunlu bir fallback_text taşır.

PropTürZorunluKısıtlamalar
titlestringHayırEn fazla 80 karakter. Yanıtların üzerindeki satır; örneğin “Where to go from here”. Model bunu yalnızca answer_pages bildiren bir derleme için yazar.
itemsarrayEvet1 ila 6 öğe.
items[].labelstringEvet1 ila 120 karakter. Yanıtlar sayfanın altındaki kartlar olduğunda tam bir soru; düz hap butonlar olduğunda birkaç kelime.
items[].iconstringHayırEn fazla 40 karakter. Bir emoji veya bir info_card simge adı. title gibi, yalnızca bir answer_pages derlemesi için yazılır.
items[].actionactionEvet{ kind: "reply", text } veya { kind: "open_url", url } veya { kind: "navigate", route } veya { kind: "call", phone } veya { kind: "copy", text } veya { kind: "add_to_calendar", title, starts_at }. Bkz. Actions.

Ağ üzerinde

{
  "id": "blk_07",
  "type": "quick_replies",
  "fallback_text": "Track order 1042, size guide, start a return.",
  "props": {
    "items": [
      {
        "label": "Track order 1042",
        "action": {
          "kind": "reply",
          "text": "Where is order 1042?"
        }
      },
      {
        "label": "Size guide",
        "action": {
          "kind": "reply",
          "text": "Show the size guide"
        }
      },
      {
        "label": "Start a return",
        "action": {
          "kind": "reply",
          "text": "I want to return something"
        }
      }
    ]
  }
}

Etkileşim

Dokunma, çipin aksiyonunu tetikler. Bir reply aksiyonu, metnini sanki kullanıcı yazmış gibi gönderir; bu nedenle metin, bir insanın söyleyeceği bir ifade gibi okunmalıdır. Bir open_url, sayfayı uygulama içi tarayıcıda açar veya ayarladığınızda RendelConfig.onOpenUrl tanımınıza gider; yalnızca https kabul edilir. Bir çip, derlemenin bildirdiği herhangi bir aksiyon türünü taşıyabilir: reply, open_url, navigate, call, copy veya add_to_calendar (bkz. Actions). app_action geçerli bir blok aksiyonu değildir. Bunu veya derlemenin bildirmediği bir türü taşıyan bir blok, fallback_text içeriği olarak çizilir ve yanıtın geri kalanı bundan etkilenmez.

Durumlar

DurumSDK'nın çizdiği içerik
YükleniyorEtiketler geldiğinde sayfanın kaymaması için gerçek 44pt yüksekliğinde üç adet hap şeklinde yer tutucu.
BoşBoş bir items dizisi, görünmez bir blok yerine fallback_text render eder.
SeçildiWeb'de dokunulan çip seçilmiş olarak işaretli kalır; Flutter çipleri seçili durum tutmaz. Her iki durumda da dokunma yanıtını gönderir ve sohbet devam eder.

Erişilebilirlik

Her çip kendi etiketini seslendirir ve tek karakterlik bir etiket dâhil her iki eksende de 44pt'lik bir hedeftir. Çipleri atlayan bir ekran okuyucu kullanıcısının nelerin sunulduğunu yine de bilmesi için fallback_text, sunulan seçenekleri virgülle ayrılmış şekilde listelemelidir.