Tutorial: Functions API

 

Overview

 

No one has ever described me as a JavaScript expert. I’m quite happy about that. Herein we’ll document the Functions API, which is accessed by you with JavaScript, but which is implemented in Swift. For the sake of providing an unambiguous reference for each aspect of this API, all of the types will be described in Swift. If JavaScript had wanted unambiguous documentation, it would have provided anything resembling a meaningful type system.

 

Note: This page is all about the Functions API. You may want to start with a high-level overview of Functions, which you can find here.

 

Main

 

func streamieMain(_ buttonName: String, _ buttonValue: String)

 

Function execution begins with the streamieMain() function. Passed to this function is the name of the button the user pressed, and the value of that button. This is all set by you in the Function configuration.

 

vContext

 

vContext is a global variable that provides important context to the execution of your Function and it provides access to all of the other data configured in your Function.

 

func log(_ message: String) -> Void

 

vContext.log(“Something important!);

 

The log() function writes a message to the console. You can see the console when running the Function manually: when you use the “Run Test” button or any of the buttons you’ve defined on the Function, the console window will appear automatically.

 

func alert(_ message: String) -> Void

 

vContext.log(“This is a message to be shown to the user.”);

 

The alert() function will use a UIAlertController instance to display a message to the user. This is only true in some contexts, such as when the user manually triggers the Function. If the Function is triggered by a motion event, or by a remote control event, the alerts are not displayed to the user.

 

func paramValue(_ key: String) -> Any?

 

const cameraId = vContext.paramValue(“cameraId”);

if (typeof cameraId === ‘string’ && cameraId !== null) {

// …

}

 

The paramValue() function provides contextual information related to the execution of the Function. For instance, if the Function was triggered by a Camera Action, the ID of the camera (“cameraId”) is set as one of the param values on the context object so that your Function can understand why it was triggered.

 

listOfCameraIds() -> [String]

 

listOfCameras() -> [Camera]

 

listOfServers() -> [Server]

 

listOfMembers() -> [Member]

 

listOfFunctionsAndButtons() -> [FunctionAndButton]

 

cameraWithName(_ name: String) -> Camera?

 

cameraWithIdentifier(_ cameraId: String) -> Camera?

 

memberWithName(_ name: String) -> Member?

 

StreamieFetchRequest

 

func createFetchRequest(_ url: String, _ method: String) -> StreamieFetchRequest

func fetch(_ callback: JSValue) -> Void

 

The fetch() function calls the callback with the StreamieFetchResponse when the request is complete.

 

const url = ...;

 

const request = StreamieFetchRequest.createFetchRequest(url, “GET”);

request.fetch((response) -> {

// …

}));

 

StreamieFetchResponse

 

var code: Int { get }

var body: Data? { get }

 

Camera

 

var identifier: String { get }

var name: String { get }

var addr: String? { get }

var port: Int { get }

 

var username: String? { get }

var password: String? { get }

 

func getRtspUrl(_ callback: JSValue)

 

Server

 

var identifier: String { get }

var name: String { get }

 

func write(_ data: StreamieFetchResponse, _ path: String, _ file: String, _ callback: JSValue)

 

Member

 

var identifier: String { get }

var name: String { get }

 

func control(_ command: String, _ option1: String?, _ option2: String?, _ option3: String?, _ callback: JSValue)

func runFunction(_ lambdaAndButton: FunctionAndButton, _ option3: String?, _ callback: JSValue)

 

FunctionAndButton

 

var lambdaId: String { get }

var buttonId: String { get }

 

 

Created

 

1 month ago

 

Related Topics

 

Functions Tutorial

 

About Streamie

 

Streamie provides a best-in-class user experience on your iPhone, iPad, Apple TV and Apple Silicon Mac, with an intuitive user interface that makes it simple to discover, stream, record, monitor and share your HomeKit, Google Nest, Ubiquiti UniFi Protect and ONVIF-compatible IP and RTSP cameras. Streamie keeps you informed with motion event notifications and it works with most cameras using its advanced audio and video codec support. You can watch your cameras from anywhere, record 24/7 to your private NAS, remotely manage multiple locations, device permissions and seamlessly synchronize settings across your devices; configure Hubitat smart home automations, live stream to YouTube and rely on the in-app technical support system when you need help (but you can also reach us by phone). Download Streamie today for all of your CCTV needs.