tuyacloud-php

PHP Library to access to the SmartLife / Tuya objects using the Tuya Cloud API.

Note: you need a Smartlife Account created with an email, not with Google Connection or similar third party. You could also create a new account from email and then invite this account to the "family" of your main Smartlife Account.

Required

A developer account must be created on the Tuya platform. I'm not sure how the details, but from the menu, access to Cloud > Development and create a cloud project.

Once the project is created, it will show you the access key and access secret.

Under the tab devices, you can tie the project with your Tuya/SmartLife app by scanning a QR Code. If it worked, you will see all your devices listed on this page (with their device_id).

You need to know which region/server you're using, and then you have to use the correct URL:

• China Data Center: https://openapi.tuyacn.com
• Western America Data Center: https://openapi.tuyaus.com
• Central Europe Data Center: https://openapi.tuyaeu.com
• India Data Center: https://openapi.tuyain.com

Usage

<?php
require 'TuyaCloud.php';

$options = [
  'baseUrl' => 'https://openapi.tuyaeu.com', // URL API of Tuya
  'accessKey' => 'nhepe4mrrtz8wju45mk3', // access key of your app
  'secretKey' => 'sf94ryyrfvg3awvg4174m88wjpksytre', // access secret of your app
];

$tuya = new TuyaCloud($options);
try {
  // to get the device status
  // you must pass the device_id
  $response = $tuya->getDevice('bfa18afnfyre87eb7ne0');
  echo '<pre>';
  print_r($response);
  echo '</pre>';
  
  // to send a command 
  // you can pass a JSON string: '{"commands":[{"code":"switch_led","value":true}]}'
  // or a strClass object
  // or an array like the below one:
  $commands = [
    "commands" => [
      [
        "code" => "switch_led",
        "value" => true
      ]
    ]
  ];
  $response = $tuya->setDevice('bfa18afnfyre87eb7ne0', $commands);
  
  // we can retrieve all the scenes (including their id)
  $response = $tuya->getScenes();
  echo '<pre>';
  print_r($response);
  echo '</pre>';
  
  // and we can start a scene
  $response = $tuya->startScene('the_scene_id');
} catch (Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
?>

The different commands can be foundby going to your project in the Tuya Cloud Development platform, then click on the device and you can find the options.

Examples:

• a curtain can have the command open, close, or stop
• a light will have switch_led with true or false
• a power strip with 2 outlets will have switch_1 with true or false, and the same for switch_2