Skip to content

favnec5/cordova-plugin-siri-shortcuts-test

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cordova-plugin-siri-shortcuts

Heads up!

The plugin only works in XCode 10, and on the iOS 12 platform.

Information

This plugin adds support for donating and removing Siri Shortcuts. The plugin adds the cordova.plugins.SiriShortcuts to the global space, but this is only available after the device has been initialised.

Installation

This requires Cordova 6.0+

cordova plugin add cordova-plugin-siri-shortcuts

Api reference

donate(options, success, error)

Donate shortcut to Siri

present(options, success, error)

Present shortcut to the user, will popup a view controller asking the user to add it to Siri. If the shortcut exists, will popup a view controller asking the user to modify or delete it.

remove(persistentIdentifiers, success, error)

Remove shortcuts based on identifiers

removeAll(success, error)

Remove all shortcuts from the application

getActivatedShortcut(success, error)

Get the current clicked user activity, and return null if none

getAll(success, error)

Get all shortcuts from the application

donate(options, success, error) ⇒

Donate shortcut to Siri

Kind: global function
Returns: void

Param Type Description
options object Options to specify for the donation
options.persistentIdentifier string Specify an identifier to uniquely identify the shortcut, in order to be able to remove it
options.title string Specify a title for the shortcut, which is visible to the user as the name of the shortcut
options.suggestedInvocationPhrase string Specify the phrase to give the user some inspiration on what the shortcut to call
options.userInfo object Provide a key-value object that contains information about the shortcut, this will be returned in the getActivatedShortcut method. It is not possible to use the persistentIdentifier key, it is used internally
options.isEligibleForSearch boolean This value defaults to true, set this value to make it searchable in Siri
options.isEligibleForPrediction boolean This value defaults to true, set this value to set whether the shortcut eligible for prediction
success function Function to call upon successful donation
error function Function to call upon unsuccessful donation, for example if the user has an iOS version < 12.0

present(options, success, error) ⇒

Present shortcut to the user, will popup a view controller asking the user to add it to Siri. If the shortcut exists, will popup a view controller asking the user to modify or delete it.

Kind: global function
Returns: void

Param Type Description
options object Options to specify for the shortcut
options.persistentIdentifier string Specify an identifier to uniquely identify the shortcut, in order to be able to remove it
options.title string Specify a title for the shortcut, which is visible to the user as the name of the shortcut
options.suggestedInvocationPhrase string Specify the phrase to give the user some inspiration on what the shortcut to call
options.userInfo object Provide a key-value object that contains information about the shortcut, this will be returned in the getActivatedShortcut method. It is not possible to use the persistentIdentifier key, it is used internally
success function Function to call upon successful donation. Data returns a key-value object containing: { code: string; message: string; phrase: string; }. The code and message values are:
  • "1" --> "Siri shortcut created."
  • "2" --> "Siri shortcut modified."
  • "3" --> "Siri shortcut deleted."
  • "4" --> "Siri shortcut dismissed."
  • "5" --> "Internal error occured."
  • "6" --> "Error while performing shortcut operation, user might not run iOS 12."
  • "7" --> "Error while performing shortcut operation, no persistent identifier sent."
error function Function to call upon unsuccessful donation, for example if the user has an iOS version < 12.0 or if is not sended persistentIdentifier

remove(persistentIdentifiers, success, error) ⇒

Remove shortcuts based on identifiers

Kind: global function
Returns: void

Param Type Description
persistentIdentifiers string | Array.<string> Specify which shortcut(s) to delete by their persistent identifiers
success function Function to call upon successful removal
error function Function to call upon unsuccessful removal

removeAll(success, error) ⇒

Remove all shortcuts from the application

Kind: global function
Returns: void

Param Type Description
success function Function to call upon successful removal
error function Function to call upon unsuccessful removal

getActivatedShortcut(options, success, error) ⇒

Get the current clicked user activity, and return null if none

Kind: global function
Returns: void

Param Type Description
options object Options to specify for getting the shortcut
options.clear boolean Clear the currently activated shortcut, defaults to true
success function Function to call upon succesful fetch. Data returns either null when there is no activated shortcut, or a key-value object containing: { persistentIdentifier: string; title: string; userInfo: object; }
error function Function to call upon unsuccessful removal

getAll(success, error) ⇒

Get all shortcuts from the application

Kind: global function
Returns: void

Param Type Description
success function Function to call upon successful. Data returns an array of key-value object containing: { persistentIdentifier: string; invocationPhrase: string; }
error function Function to call upon unsuccessful

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •