Automasi

Automasi

Gunakan pratetap atau peraturan sendiri untuk mengubah papan kekunci semasa menaip tanpa menggantikan tetapan yang disimpan.

Peraturan keadaan menggunakan tetapan sementara selagi syaratnya dipenuhi. Gabungkan orientasi, lebar tetingkap, penampilan, bahasa, susun atur, sifat medan input, masa atau keadaan yang diisytiharkan oleh pemalam. Pilih sama ada semua syarat atau mana-mana satu syarat perlu dipenuhi. Konteks yang tidak diketahui tidak pernah memenuhi syarat negatif.

Peraturan acara berjalan apabila papan kekunci dibuka, bahasa atau sifat medan berubah, pemalam mengeluarkan acara, atau anda mengetik pintasan. Arahan berjalan sekali bagi setiap acara. Tetapan sementara kekal sehingga papan kekunci ditutup, peraturan diubah atau penggantian sesi dikosongkan.

Tetapan yang disimpan kekal sebagai asas

Peraturan digunakan di atas tetapan tersimpan semasa. Seret untuk menukar keutamaan; peraturan yang terkemudian mengatasi yang terdahulu. Mematikan peraturan membuang kesannya. Perubahan yang anda simpan masih tersedia selepas penggantian sementara berakhir. Tindakan profil bersifat sementara dan tidak memilih atau menulis semula profil yang disimpan.

Pratetap kompak menggunakan baris kekunci setinggi 28 poin dan 80% daripada lebar yang disimpan, dalam had saiz sedia ada. Apabila pemisahan diaktifkan, kekunci yang lebih kecil memberi lebih ruang di antara kedua-dua bahagian dan mengekalkannya dekat tepi. Mod sebelah tangan mengekalkan penjajarannya. Peratusan sentiasa berdasarkan nilai yang disimpan dan tidak berganda pada setiap penilaian.

Pratonton menggunakan contoh konteks yang anda pilih. Ia menunjukkan syarat yang dipenuhi, rujukan tidak sah dan tetapan yang dijangka tanpa menjalankan arahan. Pratonton aplikasi berasingan daripada papan kekunci aktif. Tambah Automasi pada bar atas untuk melihat penggantian aktif dan menjalankan peraturan melalui pintasan.

Apabila peristiwa berlaku

Penilaian berlaku semasa papan kekunci aktif. Peraturan masa tidak berjalan di latar belakang dan acara penutupan tidak dijamin. Clink tidak boleh mengenal pasti aplikasi hos atau menukar tetapan iOS. Peraturan mengekalkan syarat Keahlian, Akses Penuh dan ketikan pengguna bagi ciri yang digunakan. Import tidak memberikan kebenaran.

Kontrak pemalam

Objek automation pilihan dalam fail .clinkplugin mengisytiharkan acara, keadaan, tetapan, arahan, pratetap dan slot pintasan. Setiap sumbangan mempunyai ID tetap, versi skema yang tepat dan tajuk setempat. Hos membentuk nama plugin/<plugin-id>/<kind>/<id>. Pemalam tidak boleh menggunakan ruang nama teras atau ruang nama pemalam lain.

Keadaan yang diterbitkan, data acara dan argumen arahan menerima nilai boolean, nombor berhad dan pilihan yang diisytiharkan. Tetapan juga boleh menggunakan teks dengan panjang terhad. Keadaan dan tetapan menggunakan kunci dalam kamus keadaan pemalam yang sedia ada. Nilai sementara dipulihkan sebelum disimpan. Pratetap ialah peraturan biasa yang dimatikan dan mesti dipilih secara nyata.

Cangkuk

Acara yang diisytiharkan dan arahan selamat

Petikan manifes ini diletakkan dalam medan automation fail pemalam biasa. Skripnya menerbitkan sama ada papan kekunci sedia, mengeluarkan acara dan mengemas kini tulisan. Dalam editor, pilih acara tersebut, tetapkan syarat keadaan ready dan pilih arahan caption. Membaca contoh ini tidak memasang atau mengaktifkan sebarang pemalam.

{
  "schemaVersion": 1,
  "events": [
    {
      "id": "ready",
      "title": {
        "en": "Keyboard ready"
      },
      "version": 1,
      "payload": [
        {
          "id": "ready",
          "key": "ready",
          "title": {
            "en": "Ready"
          },
          "version": 1,
          "type": "bool",
          "choices": [],
          "minimum": 0,
          "maximum": 100,
          "defaultValue": null
        }
      ]
    }
  ],
  "state": [
    {
      "id": "ready",
      "key": "ready",
      "title": {
        "en": "Ready"
      },
      "version": 1,
      "type": "bool",
      "choices": [],
      "minimum": 0,
      "maximum": 100,
      "defaultValue": null
    }
  ],
  "settings": [
    {
      "id": "show_caption",
      "key": "show_caption",
      "title": {
        "en": "Show caption"
      },
      "version": 1,
      "type": "bool",
      "choices": [],
      "minimum": 0,
      "maximum": 100,
      "defaultValue": true
    }
  ],
  "commands": [
    {
      "id": "caption",
      "title": {
        "en": "Refresh caption"
      },
      "version": 1,
      "arguments": [],
      "behavior": "localUI",
      "requiresUserGesture": false,
      "requiresFullAccess": false
    }
  ],
  "presets": [],
  "shortcuts": [
    "run"
  ]
}

def initial():
    return {"ready": False, "show_caption": True}

def on_open(state):
    state["ready"] = True
    automation_publish("ready", True)
    automation_emit("ready", {"ready": True})
    return state

def on_automation(command, args, state):
    if command == "caption":
        space_text("Clink" if state["show_caption"] else None)
    return state

def bar_items(state):
    return [bar_button("run", "Run automation", icon="bolt.circle")]

def on_action(action, value, state):
    if action == "run":
        automation_run("run")
    return state

Kongsi peraturan dengan teliti

Import dan eksport JSON daripada Automasi. Peraturan yang diimport dimatikan, diberi identiti baharu dan mengekalkan rujukan tema, susun atur serta pemalamnya. Rujukan yang hilang perlu dipulihkan sebelum peraturan boleh berjalan. Peraturan bersifat global dengan skop profil pilihan; ia berasingan daripada eksport profil dan penyegerakan iCloud.

{
  "schemaVersion": 1,
  "shortcutBindings": {},
  "rules": [
    {
      "id": "landscape-split",
      "name": "Landscape split",
      "enabled": false,
      "schemaVersion": 1,
      "kind": "state",
      "trigger": "keyboard.open",
      "triggerVersion": 1,
      "cooldownSeconds": 1,
      "conditions": {
        "mode": "all",
        "items": [
          {
            "id": "landscape",
            "field": "interface.orientation",
            "comparison": "equals",
            "value": "landscape",
            "upper": null,
            "hysteresis": 0,
            "version": 1
          }
        ]
      },
      "actions": [
        {
          "id": "split",
          "kind": "set",
          "target": "layout.split",
          "value": true,
          "version": 1
        }
      ]
    }
  ]
}

Skema dan had

Versi 1 menyokong 128 peraturan, 24 syarat dan 32 tindakan bagi setiap peraturan, dengan import sehingga 1,048,576 bait. Daftar tetapan menyediakan 268 sasaran dan menerangkan 39 pengecualian. Kumpulan tetapan yang tidak sah ditolak sepenuhnya; arahan berhenti pada kegagalan pertama tanpa menjanjikan pembatalan kesan sebelumnya.

Sumbangan pemalam yang dibuang, dimatikan atau tidak serasi menjadikan peraturan berkaitan tidak tersedia. Ranap dan tamat masa melumpuhkan sumbangan yang gagal untuk sesi itu. Arahan diberi 20,000 langkah dan had masa yang singkat. Baris gilir berhad, sela antara pelaksanaan, had rantaian dan penstabilan keadaan mencegah acara berulang daripada berjalan tanpa henti.

Widget

Clink membawa tiga widget skrin utama dan satu Live Activity: penukar profil, statistik taipan anda, imlak pantas, dan sesi imlak itu sendiri.

Widget membaca fail tetapan yang dikongsi secara terus, jadi ia terus berfungsi walaupun app ditutup.

App Intents

Dua intent disertakan hari ini, dan tiada satu pun membuka app. Switch Keyboard Profile menulis semula tetapan yang dikongsi daripada widget, dan papan kekunci yang sudah berada di skrin menerima perubahan itu serta-merta. End Dictation mencapai sesi mikrofon daripada Live Activity, dan melancarkan app di latar belakang jika perlu.

Bertukar kepada profil buatan anda sendiri memerlukan Keahlian, dan semakan itu turut berjalan di dalam widget. Profil yang disertakan bersama Clink adalah percuma.

Clink tidak mentakrifkan frasa Pintasan sendiri, jadi tiada apa-apa untuk disebut dengan suara.

Pautan

Clink menjawab skema URL clink miliknya sendiri. Satu pautan membuka app pada halaman yang anda namakan, atau menjalankan salah satu laluan terpelihara.

Imlak, keahlian dan pengesahan adalah terpelihara, jadi ia tidak boleh digunakan sebagai nama halaman.

Membuka fail

Clink mendaftarkan jenis failnya dengan iOS, jadi Fail, AirDrop, Mesej dan mana-mana helaian kongsi menawarkan untuk membukanya dalam Clink.