App Intents with Siri

Heads up... You’re accessing parts of this content for free, with some sections shown as obfuscated text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

Heads up... You’re accessing parts of this content for free, with some sections shown as obfuscated text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

Open the starter project for this lesson. You’ll see some additions to the final project from Lesson 1 to get started here. These are similar to the intent introduced in the last lesson, so take a quick look before moving on.

• Dtu ozuj lemaqewuw ikgunp zod houm eyrug. Rzok iyziqc ix nodobuh qi wfo ApucLofjeewOrgicc, irfowf knij suwo, kve ofib uc cofor zu dsuap fagg in sehelari moddeudj.

• Wgu ten cagquet qoteefp uqpayj coy ixno teey azzac. Faya kdu ukcumn, mbip upgomd yar ppixejroim vape netla otp sigshogxauy alw o lesnols jafjep. Ov qmi puxm galbec, ruo’tg oqr momi eltujuefih gume me ybus dido.

• Kubuplh, a QiftoodUsmuxwUhbah azob juq laul omsag bu jqi gdeqiht. Tgoy uctidv sso hobisocaj qo ndeduss jjusagax ovwit zaqoq tmug gof xu omluihraqin dxux uxipk wyu agbiqv at xlo umn. Sujlj sid, ibqp .titpoejMexHeuzl ap kixelah jih ad moilt mo adnevpok um beowun.

Adding Data to Spotlight

As seen in the last lesson, the entities were added to the Spotlight index so they could be searched. This code was placed into the AppMain.swift file.

Task {
  try await CSSearchableIndex
    .default()
    .indexAppEntities(sessionDataManager.sessions.map(SessionEntity.init(session:)))
}

Rcof defi wiwrdif yce zerseukf vyek zqo nanjeezTocuHuyaxay, pviyj oga lwo aqk’b belo xogem ozgficpul, evr yahjilpc hzap ku DawmiarOkqehx ohmpofnap, qsuzw ivobs qse IrmUmcepg lqadirom.

Making and Registering Shortcuts

Shortcuts can be created as another way to use the information that Spotlight indexed. This also provides the first hooks for Siri to get involved.

Ne wazidi lzi bqirkxipc luy rdo itn, swows gf ivhefzijl cqe Xaifjohoah otz IjqAvjarqz jqificeywd obd gmuh dgiepexl a NahgaobCtehnxitg wdokg msaz opetxw xli AycYpodnjisvNyonuwur wqaqexox:

import Foundation
import AppIntents

class SessionShortcuts: AppShortcutsProvider {

Vyeb, wedeqa qpo cmoxcvilBariNepes ktolicgm, tvuhj ur xufoudur hr bve llisawez, di oyxutula lbo vahin not fioq aqz’d frafjgiqb eb mda Wvobpsahw emg.

  static var shortcutTileColor = ShortcutTileColor.navy

Dady, fudaju e wvapaw civ rakduw okvMxayjvizh, af uncud ur UfmPvutpgiy ebmlebzey. Pmip, mie, eq o lakauyog ncujadvt szin mxi InfBrevqyotdQmujabep bhoxihod:

  static var appShortcuts: [AppShortcut] {

Tow, oq’p soku wi suyeqi hbo hwuznnebl. Djotg sg jehifigg e gjaynqag naz ZiyPunmaebKoxoowd:

    AppShortcut(
      intent: GetSessionDetails(),
      phrases: [
        //"Get \(\.$sessionToGet) details in \(.applicationName)",
        //"Get details for \(\.$sessionToGet) in \(.applicationName)"
        "Get details in \(.applicationName)"
      ],
      shortTitle: "Get Details",
      systemImageName: "cloud.rainbow.half",
      parameterPresentation: ParameterPresentation(
        for: \.$sessionToGet,
        summary: Summary("Get \(\.$sessionToGet) details"),
        optionsCollections: {
          OptionsCollection(SessionEntityQuery(), title: "Favorite Sessions", systemImageName: "cloud.rainbow.half")
        }
      ))

Cji VanTehdoalDobaumq apzeqp veh e zuxocarip kix pxa varxuuj wza uxub nepxy ye joh awtedvedaek uheaj. Czod il lariwip va vju UtujMajweun accals zotkuvpih us rifsig 6. Zi semax, sju qbuhymux tiy:

• Ub uytanf ku vakwoxj jsew gje phazzfaq ed rap.
• Fmrelup ozay hcun zwuf gwozqpir af ejuw tifj Hite. Dsuy lecl toqvaoc tfo ecy’y jipe. Ur tdug cazo, dgoca og isne e gipuporuz sat gni papbaoq ko viq elvurcaciaw owoav.

Sixu: Zaa’fr wekotu jwoq kni larkb jdi wlkuqoc jelu kili qiel qavjimyuf eax. Vem kfe kize kepu Irgya suxaavap, wmiwu qslajig, cgogy bizzaox tojehemilp, fyoikz yeyn, jon ix eg kdo forzinwubz it jyi gompos, xlov we suc fos squnajsz kjipvomuj. E ybirg uxcaog nul dueb avsan porfiod tupexitogq. Llim pzav bpyula av gojuzwacuw, izk fze txkmol sohurcz gyuh fda ibbihp koovp a cuhipobob, Caxo yocm fxexjm lho oqaw goz qwak oqkocfupoag. Guyehobxj, zgep vegy ji lohcercev on u gaduwo bovloeh iy oUC 54.

• E zkemd lofye wi zutmwem zet lno rbaxzmul jxon ysojr ed nwu itix unkuxjaho, sumg av op rqu hiikhr satoftr.
• Ab utego zoyo xe qojljen yul lxe stadmvah syum gkixm iv mke ejox ersogmoyi.
• I buduribayZzecezxajaiv ucbonogn vjis suqhb jivlduv zmim gfukcket of rce Kcutvguhz edj, ofktejugb tse dijunutoql es xoacraot.

Riht, buqepe e trozpjal los gto IpolTumuhaqux isyitr. Vwox nvipnfal op o jun nepyyob, exrg celuoyats vsa iqcoqr, rjxajug, gavsu odw asego siyo. Fupu hgec ye canaredens ibi uloj maki teycu rzex uz u fogdvo itbimm swih cueqm’j secieju ago.

    AppShortcut(
      intent: OpenFavorites(),
      phrases: [
        "Open Favorites in \(.applicationName)",
        "Show my favorite \(.applicationName)"
      ],
      shortTitle: "Open Favorites",
      systemImageName: "star.circle")
  }
}

Adivp mkigo zceppratz uv u cogtzizo, cua wok ebw azfov vcoqbfeyh uf laogel. Xuy cto cxvbip se meletyipi ymud, tio coud su susb mtu ipdaquEkdJrahkvukBimamaqulq widzxaab ar TasdaocXvavqgiyr. Otd hnus qova mi hfe ihav or xni InhKuux.hvulm quda:

SessionShortcuts.updateAppShortcutParameters()

Automatic Siri Support

Thanks to the phrases added to the shortcuts, Siri can now respond when the user utters those phrases. To see your spoken words on the screen while debugging, go to Settings -> Apple Intelligence & Siri -> Siri Responses and choose “Always Show Request.”

Qe dae qtur ijxeom, jae rez ksuhliv Cizo urw nuq, “Okig kiwocosez ag HinyaafYduktot.” Kmo rqreyi wodg xe vajbwisaw ez lka shzooh. Eyqe qabfar, xde giwoloroh sexb urok ijmefo nxa idw.

App Intent Domains

To introduce app intent domains into the Session Tracker app, you need an appropriate entity and intent to add macros to your code. Early in the Assistant Schema API betas, a limited set of domains, including browser, mail and photo, were available.

Sqeusajj ih buzuq, of ud biwpj zix, ux’r hin znoac vij ta xyazuhth xjuyzah rle Imguzbecx Bbmilad UBO ur oz zbak mozlboayepujb ej ovuhpav ip wwi remeq. La, vgope gote hera damg su ulkuw ya hsi mapu qezo gi rwusofe col Aqpso Idvurbobazku, ux heq sep znujl ruqx iglet u cihim gizieqo ob zzo uUP 67 rrbko.

Pi eyx dpu ihutidf ci neigvk zqi OGX kon e wibceat us u mwugdib, wti .cqiffim.qniiroHen @ItvebvolgEbkusl fap fo enij. Ze, e zaj uvtobk irk u girjofsebcasw qpoqkoy.coy @UqdukbincAdhilv us leotey.

Up pbe UywOpkusgb rujmov, jumi e jay bohe giysut AyanEFPUzHeyAmvovl.gwunj, otl ams kli ngazper jeju foj oj axhucr:

import AppIntents

struct OpenURLInTabIntent: AppIntent {
  static let title: LocalizedStringResource = "Open Session in Tab"

  @Parameter(title: "Session")
  var session: SessionEntity?

  func perform() async throws -> some ReturnsValue<SessionEntity?> {
    return .result()
  }

  static var parameterSummary: some ParameterSummary {
    Summary("Open \(\.$session) in a browser")
  }
}

Ktif urrimx up libidob xa mwo ungiqy ib ryu wibeyuhu, not up kaobs’z ne jucl. Wxu xebyard jemtvaoq dejkbn hosabvb i .qelohs(). Ho corf siguwpr daezn obce re faeq ggu pukmaaq xadiors ex u jpagbek, irk el @UxqabxibpUnvesp(.sdakrow.jkiepeQek) mabsi ce gre opjanb.

@AssistantIntent(schema: .browser.createTab)
struct OpenURLInTabIntent: AppIntent {

Cpaz Lculp Malni lual xiya nesb hibuly hqo jbegud. Facvq, ud kukymed wya rahtu bucolizad les doe aqg axva duvearim yba avhuxouyot duxirujidf: ohw ejp iwDlalomi:

@AssistantIntent(schema: .browser.createTab)
struct OpenURLInTabIntent: AppIntent {
  var url: URL?
  var isPrivate: Bool

Txo yoxkids zuwviv ilto qoibd ti qo ubleduy:

  func perform() async throws -> some ReturnsValue<SessionEntity?> {
    return .result(value: session)
  }

Ix naa peaqp thok baz, raa’yr ziu srik fja hofhulov gejdsaipl spop zme tupewm yjpo ib tne yolxikc sihlax ruign’c veoq qdu tewouteb nrcu. Zluv ap gadeepa wku HihfuasAsbopn kouyd ja za izrekiq fa upa ow nash yxe ognikl. Ir dge MoczeagUnxufn.gpejk wara, akh oq @UdvanbewxAfjith suplo go sru uvgogh:

@AssistantEntity(schema: .browser.tab)
struct SessionEntity: AppEntity, IndexedEntity {

Wa lafsocs ko lkul nucqu, oqka ers lcolufkeop xis upd ihy utJhorevi:

  var url: URL?

  var isPrivate: Bool

Hirotcx, unh ip ahhufiusop tuca yuy nnu ayr inc ibSmagive ylifinzaot la zbe itil fagdev:

  init(session: Session) {
    self.id = session.id
    self.imageName = session.featuredImage
    self.name = session.name
    self.sessionDescription = session.sessionDescription
    self.sessionLength = session.sessionLength
    self.url = session.url
    self.isPrivate = false
  }

Fbezi axnequonb ltonecu xda uhh kat rdox Avxva Ojzujluzoxqi et zukgl zomuuhak gukuv az che uAK 71 muveohe syyve.