The Handy Script Server helps platforms that integrate with the Handy masturbator to store and retrieve interactive Scripts.
Some partners may wish to protect their scripted content but still allow for offline scripted video playback.
The Script APIs provide a way to allow local playback of scripts without exposing the actual position and time data to the user. This is achieved by using tokens that can be passed to the device and that allows the device to load the relevant script data from Handy servers without having any script data exposed to the user.
A token is a file with the structure and function of a regular FunScript Script. However, instead of scripted time-position data, it contains encoded data that lets the Handy script server know which script data to send directly to the Handy masturbator.
In this way, script data never passes through the user’s device to get to the Handy; rather, Handy servers send the data directly to the Handy itself, provided that the token was valid.
A token can be configured to have an expiration time. For example, you can create tokens valid for the length of a subscription or a user session. When a token expires, it can no longer play a script.
Tokens can be restricted to work only with a specific Connection Key. However, because the user can change their Connection Key at any time; using this approach will require creating a way to renew the token for a new Connection Key.
When using Handy Synced Stream Protocol (HSSP) to play videos in sync with Handy masturbator you will need to host a script. To simplify this proce for you as a developer, we provide you with a hosting API, so you do not need to host the script.
Code generator command (more on that below):
"importScriptHostingApi": "openapi --exportSchemas true --input <https://scripts01.handyfeeling.com/api/script/hosting/v0/spec> --output src/_SCRIPTHOSTINGAPI --name ScriptHostingApi",
Import the API by running: