@charliecat/capacitor-plugin-siri-shorts v5.0.0-a

Capacitor Plugin for Siri Shortcuts

Disclaimer

this is a fork of capacitor-plugin-siri-shorts running on Capacitor.js v5

🔧 Setup

The Plugin requires at least iOS 12 and Xcode 10.

npm i capacitor-plugin-siri-shorts

iOS Project

Add a new Item to NSUserActivityTypes inside your Info.plist with your Bundle Identifier:

$(PRODUCT_BUNDLE_IDENTIFIER).shortcut

Extend the application:continueuserActivity,restorationHandler function inside your AppDelegate.swift with the following line:

NotificationCenter.default.post(Notification(name: Notification.Name(rawValue: "appLaunchBySiriShortcuts"), object: userActivity, userInfo: userActivity.userInfo))

Put this line before the return statement!

The function should look similar to that:

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    NotificationCenter.default.post(Notification(name: Notification.Name(rawValue: "appLaunchBySiriShortcuts"), object: userActivity, userInfo: userActivity.userInfo))
    return CAPBridge.handleContinueActivity(userActivity, restorationHandler)
}

✨ Example Usage

A full Ionic + Angular example is available here

Basic example of the donate function:

import { SiriShortcuts } from 'capacitor-plugin-siri-shorts';

...

someAction() {
  SiriShortcuts.donate({
    persistentIdentifier: "someIdentifier",
    title: "A descriptive title"
  })
}

It's recommended to add a listener into the initializeApp() function inside app.component.ts.

initializeApp() {
  this.platform.ready().then(() => {
    
    ...
    
    SiriShortcuts.addListener('appLaunchBySiriShortcuts', (res) => {
      // do something with the response of the shortcut here
      console.log(res)
    });
  });
}

🏗️ API Reference

• donate(...)
• present(...)
• delete(...)
• deleteAll()
• addListener('appLaunchBySiriShortcuts', ...)
• removeAllListeners()
• Interfaces

donate(...)

donate(options: Options) => Promise<any>

Donates the provided action to Siri/Shortcuts

Returns: Promise<any>

Since: 1.0.0

present(...)

present(options: Options) => Promise<any>

Presents a modal to the user to add the shortcut to siri and access it via voice

Returns: Promise<any>

Since: 2.2.0

delete(...)

delete(options: DeleteOptions) => Promise<void>

Deletes the previous donations with the provided persistent identifiers

Since: 2.1.0

deleteAll()

deleteAll() => Promise<void>

Delets all the previously donated activities

Since: 2.1.0

addListener('appLaunchBySiriShortcuts', ...)

addListener(eventName: 'appLaunchBySiriShortcuts', listenerFunc: (shortcut: Shortcut) => void) => Promise<PluginListenerHandle> & PluginListenerHandle

Listens to events associated with Siri Shortcuts and notifies the listenerFunc if a Shortcuts has been executed.

Returns: Promise<PluginListenerHandle> & PluginListenerHandle

Since: 2.0.1

removeAllListeners()

removeAllListeners() => Promise<void>

Remove all listeners for this plugin.

Since: 2.0.1

Interfaces

Options

Options to specify for the donation

UserInfo

DeleteOptions

Options to specify for a deletion

PluginListenerHandle

Shortcut

Object which will be returned by the listener which contains the persistent identifier and the userinfo of a shortcut