Automaatikad
Muuda klaviatuuri kirjutamise ajal valmis- või oma reeglitega, asendamata salvestatud seadistust.
Olekureeglid rakendavad ajutisi sätteid seni, kuni tingimused on täidetud. Kombineeri suunda, akna laiust, välimust, keelt, paigutust, sisestusvälja omadusi, aega või pistikprogrammi deklareeritud olekut. Vali, kas täidetud peavad olema kõik tingimused või vähemalt üks. Teadmata kontekst ei täida kunagi eitavat tingimust.
Sündmusreeglid käivituvad klaviatuuri avamisel, keele või sisestusvälja omaduse muutumisel, pistikprogrammi sündmusel või otsetee puudutamisel. Käsud käivituvad üks kord sündmuse kohta. Ajutised sätted kehtivad klaviatuuri sulgemise, reegli muutmise või seansi muudatuste tühjendamiseni.
Salvestatud seadistus jääb aluseks
Reeglid rakenduvad praeguste salvestatud sätete peale. Lohista neid tähtsuse muutmiseks; hilisemad reeglid jäävad peale. Reegli väljalülitamine eemaldab selle muudatused. Salvestatud muudatused jäävad alles ka ajutise asenduse lõppedes. Profiilitoiming on ajutine ega vali ega kirjuta ümber salvestatud profiili.
Kompaktne valmisreegel kasutab 28 punkti kõrgusi klahviridu ja 80% salvestatud laiusest olemasolevate suuruspiiride piires. Jagatud klaviatuuril jätavad väiksemad klahvid poolte vahele rohkem ruumi ja hoiavad pooled servade lähedal. Ühe käe režiim säilitab oma joonduse. Protsendid lähtuvad alati salvestatud väärtusest ega kuhju.
Eelvaade kasutab sinu valitud näidiskonteksti. See näitab täidetud tingimusi, vigaseid viiteid ja eeldatavaid sätteid käske käivitamata. Rakenduse eelvaade on aktiivsest klaviatuurist eraldi. Lisa Automaatikad ülaribale, et näha aktiivseid asendusi ja käivitada otseteereegleid.
Kui toimub sündmus
Kui toimub sündmus
keyboard.openkeyboard.closekeyboard.languageChangedkeyboard.layoutChangedkeyboard.profileChangedkeyboard.planeChangedinput.changedtime.minuteuser.run
Tegevused
panel.closeplane.lettersplane.numbersplane.symbolsoverrides.clearpanel.emojipanel.calculatorpanel.conversionpanel.layoutspanel.profiles
Tingimusi hinnatakse aktiivse klaviatuuri korral. Ajareeglid ei tööta taustal ja sulgemissündmus pole tagatud. Clink ei saa tuvastada hostrakendust ega muuta iOS-i sätteid. Reeglid säilitavad kasutatavate funktsioonide liikmesuse, täieliku juurdepääsu ja kasutaja puudutuse nõuded. Import ei anna õigusi.
Pistikprogrammi leping
Faili .clinkplugin valikuline automation-objekt deklareerib sündmused, oleku, sätted, käsud, valmisreeglid ja otseteekohad. Igal lisandusel on püsiv ID, täpne skeemiversioon ja tõlgitud pealkirjad. Host loob nimed kujul plugin/<plugin-id>/<kind>/<id>. Pistikprogramm ei saa kasutada süsteemi ega teise pistikprogrammi nimeruumi.
Avaldatud olek, sündmuste andmed ja käsuargumendid lubavad tõeväärtusi, piiratud arve ning deklareeritud valikuid. Sätted võivad kasutada ka piiratud pikkusega teksti. Olek ja sätted kasutavad pistikprogrammi olemasoleva olekusõnastiku võtmeid. Ajutised väärtused taastatakse enne salvestamist. Valmisreeglid on tavalised väljalülitatud reeglid, mis tuleb sõnaselgelt valida.
Pistikprogrammid ›Haagid
| Haak | Millal see käivitub |
|---|---|
on_automation(command, args, state) | on_automation(command, args, state) käivitab lubatud kohaliku käsu olemasolevas liivakastis. See võib uuendada tühikuklahvi teksti, avaldada deklareeritud olekut või väljastada deklareeritud sündmuse. See haak ei tohi sisestada teksti, kasutada lõikelauda, muuta püsisätteid ega teha välispäringuid. |
automation_emit(name, payload) | Väljasta deklareeritud sündmus selle tüübistatud andmetega. Host lisab pistikprogrammi nimeruumi ja skeemiversioonid; skript ei saa ette anda kasutaja žesti ega täitmisahela eellugu. |
automation_publish(name, value) | Avalda tingimuste jaoks üks deklareeritud olekuväärtus. Väärtused kaovad klaviatuuriseansi lõppedes või pistikprogrammi kättesaamatuks muutumisel. |
automation_run(slot) | Kutsu välja pistikprogrammi natiivse juhtelemendi toimingutöötlejast. Kasutaja seob deklareeritud otseteekoha Automaatikates reegliga. Pistikprogramm ei saa reeglit salaja ise valida ega taimerist käivitada puudutust nõudvat käsku. |
Tegevused
space_textautomation_emitautomation_publish
Deklareeritud sündmus ja ohutu käsk
See manifestiosa kuulub tavalise pistikprogrammifaili automation-väljale. Skript avaldab klaviatuuri valmisoleku, väljastab sündmuse ja uuendab teksti. Vali redaktoris see sündmus, nõua olekut ready ning vali käsk caption. Näite lugemine ei paigalda ega lülita sisse ühtegi pistikprogrammi.
{
"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 stateSkeem ja piirangud
Versioon 1 toetab 128 reeglit, 24 tingimust ja 32 toimingut reegli kohta ning kuni 1 048 576 baidiseid importe. Sätete register pakub 268 sihtmärki ja kirjeldab 39 erandit. Vigased sätterühmad lükatakse tervikuna tagasi; käsud peatuvad esimese vea juures, lubamata varasemate mõjude tagasipööramist.
Eemaldatud, väljalülitatud või ühildumatud pistikprogrammiosad muudavad sõltuvad reeglid kättesaamatuks. Krahh ja ajalimiidi ületamine keelavad vigase osa seansi lõpuni. Käskudel on 20 000 sammu ja lühike ajalimiit. Piiratud järjekorrad, käivituste vahed, ahelapiirid ja oleku stabiliseerimine takistavad sündmuste lõputut kordumist.
Vidinad
Clinkiga tuleb kaasa kolm avaekraani vidinat ja üks Live Activity: profiilivahetaja, sinu kirjutamisstatistika, kiire dikteerimine ja dikteerimisseanss ise.
Vidinad loevad jagatud seadetefaili otse, seega need töötavad ka siis, kui rakendus on suletud.
App Intents
Praegu on neid kaks ja kumbki ei ava rakendust. Switch Keyboard Profile kirjutab jagatud seaded vidinast ümber ja juba ekraanil olev klaviatuur võtab muudatuse kohe omaks. End Dictation jõuab Live Activityst mikrofoniseansini ning käivitab vajaduse korral rakenduse taustal.
Enda tehtud profiilile vahetamine vajab liikmelisust ja see kontroll käib ka vidina sees. Clinkiga kaasas olevad profiilid on tasuta.
Clink ei määra omaenda Käskude fraase, nii et valjusti öelda pole midagi.
Lingid
Clink vastab oma clink URL-skeemile. Link avab rakenduse lehel, mille nimetad, või käivitab ühe reserveeritud marsruutidest.
| Viide | Mida see teeb |
|---|---|
clink://settings/<page> | Avab seadete lehe. Lisa ?anchor=<id>, et jõuda kindlale reale. |
clink://<page> | Sama leht, lühidalt kirjutatuna. |
clink://search?q=<text> | Avab otsingu juba täidetud päringuga. |
clink://analytics | Avab kirjutamisstatistika. |
clink://dictation/start | Alustab dikteerimisseanssi. |
clink://dictation/stop | Lõpetab seansi ja koristab Live Activity ära. |
clink://paywall | Avab liikmelisuse. |
clink://verify | Kontrollib liikmelisuse uuesti üle, kui õiguste kirje on aegunud. |
Dikteerimine, liikmelisus ja kontroll on reserveeritud, seega need ei kõlba lehenimedeks.
Failide avamine
Clink registreerib oma failitüübid iOS-is, nii et Failid, AirDrop, Sõnumid ja iga jagamisleht pakuvad nende avamist Clinkis.