Cam Extension for Chrome | Developer (2024)

The Cam Extension for Chrome is the best solution for cam models to stream with Lovense toys, featuring:

• Highly customizable vibration levels and patterns
• Lovense widget for quick access to settings while streaming
• Video overlay support for OBS, Streamster, SplitCam
• Games and tools to increase interactivity and earn more tips
• Frequent updates, improvements, and new features

# Step 1: Configure the developer dashboard

Go to the developer dashboardopen in new window and fill in your settings.

Status Meaning:

Pending - The website is being tested. Use test:{Website Name} name in order to add your website to the Cam Extension during the testing phase.

Active - The website is live and public. All models can see your cam site in the Cam Extension.

# Step 2: Integration

# Import the Javascript file

Import the Javascript file to your model’s broadcasting page. This Javascript will declare a global variable CamExtension on the page.

<script src="https://api.lovense-api.com/cam-extension/static/js-sdk/broadcast.js"></script>

# Initialize the instance object

Initialize a CamExtension instance on the model’s live page.

/** * @param {string} websiteName this is the Website Name shown in the developer dashboard * @param {string} modelName this is the model's name * @returns {object} CamExtension instance object */const camExtension = new CamExtension(websiteName, modelName)

# Listen for ready event

Listen for the ready event, which will be called after successful initialization. You can communicate with the Cam Extension after this event is triggered.

/** * readyCallback * @param {object} ce CamExtension instance object */const readyCallback = function (ce) { // Handle the CamExtension instance object // e.g. await ce.getCamVersion()}camExtension.on("ready", readyCallback)

# Step 3: Methods & events

# Methods

• receiveTip

  See Also

  Lovense Max 2 and Nora Review: The Best Long Distance Set?

  Call this method when the model receives a tip. The Cam Extension will trigger a response in the toy according to these parameters:

  /** * receiveTip * @param {number} amount tip amount that the model receives * @param {string} tipperName this is the tipper’s Screen Name */camExtension.receiveTip(amount, tipperName)

• receiveMessage

  Call this method when the model receives a message in the chat room.

  /** * receiveMessage * @param {string} userName the sender’s Screen Name * @param {string} content the message just sent by the sender */camExtension.receiveMessage(userName, content)

• getSettings

  Get the model's Lovense Settings.

  /** * getSettings * @returns {object} model's Lovense Settings */const data = await camExtension.getSettings()// data = {// levels: {// level1: {// min: 1,// max: 9,// time: 2,// rLevel: 0,// vLevel: 0,// },// level2: {...}// level3: {...}// },// special: {// earthquake: {// enable: true,// type: "earthquake",// time: "22",// token: "120",// },// fireworks: (...),// wave: (...),// pulse: (...),// random: (...),// randomTime: (...),// giveControl: (...),// pause: (...),// clear: (...),// }// }

• getToyStatus

  Get the model's Lovense Toys status.

  /** * getToyStatus * @returns {array} model's Lovense Toys status. */const data = await camExtension.getToyStatus()// data = [// {// id: "l58f167da065",// name: "",// type: "lush",// status: "on"// },// {...}// ]

• getCamVersion

  Get the Cam Extension version.

  /** * getCamVersion * @returns {string} Cam Extension version */const data = await camExtension.getCamVersion()// data = "30.4.4"

# Events

You can listen for certain events to get the latest real-time data

• sdkError

  Listen for error messages from the SDK.

  camExtension.on("sdkError", (data) => { console.log("sdk error", data.code, data.message)})

• postMessage

  We will trigger this event when we need to send a message to you or the chat room, and you will need to help us handle it accordingly.

  camExtension.on("postMessage", (message) => { // Process the message to be sent // Send the message to chat room // e.g. message = "My LOVENSE Lush is now reacting to john's tip. It will stop after 5 sec!"})

• toyStatusChange

  We will trigger this event when the toy status changes.

  camExtension.on("toyStatusChange", (data) => { // Handle toy information data // data = [{ // id: "d6c35fe83348", // name: "toy's name", // type: "lush", // status: "on", // version: "", // battery: "80" // }]})

• tipQueueChange

  We will trigger this event when the tip queue updates.

  camExtension.on("tipQueueChange", (data) => { // handle queue information data // data = { // running: [ // { // amount: 100, // tipperName: "john", // time: 20, // module: "Special Command", // cParameter: {}, // level: "", // specialType: "earthquake", // modelName: "coco", // reactToys: [, // toyId: "d6c35fe83348", // specialType: "earthquake", // status: 1, // toyType: "lush", // ] // } // ], // queue: [...], // waiting: [...] // }})

• settingsChange

  We will trigger this event when the model’s Lovense Settings are updated.

  camExtension.on("settingsChange", (data) => { // handle configuration information data // data = { // levels: { // level1: { // min: 1, // max: 9, // time: 2, // rLevel: 0, // vLevel: 0, // }, // level2: {...} // level3: {...} // }, // special: { // earthquake: { // enable: true, // time: "20", // token: "100", // }, // fireworks: ( // enable: true, // time: "22", // token: "120", // ), // giveControl: ( // enable: false, // time: "", // tokensBegin: "", // tokensEnd: "", // ), // randomTime: ( // enable: true, // tokens: "38", // minTime: 10, // maxTime: 50, // level: 5, // ), // pause: (...), // pulse: (...), // random: (...), // wave: (...), // } // }})