通用电气 - SmartHQ API 的 PHP 封装器

1.0.0 2022-01-01 16:14 UTC

This package is auto-updated.

Last update: 2024-09-13 16:15:20 UTC


README

这个库是一个简单的 PHP 封装器,用于通用电气/SmartHQ API。目前,由于我没有列出所有要测试的设备,所以库只使用了 API 的单个端点。如果您需要支持更多设备,您可以自己实现调用和函数,并通过创建 pull request 将其合并到主分支。

额外需要的库(包含在主包中)

支持的设备

  • 分体空调

安装

您可以使用 composer 安装此库,或者简单地下载此存储库并将其包含到您的项目中。使用 composer 安装

composer require giannisftaras/ge-api

用法

请确保实现一个存储对象,以便在登录流程中存储生成的 Bearer / 访问令牌,这有助于加快加载速度,并在查询 API 时避免频繁登录。

<?php
	require  __DIR__  .  '/../vendor/autoload.php';
	$auth = parse_ini_file(__DIR__  .  '/auth.ini');

	session_start();
	# Get the stored GE Bearer token from $_SESSION or from wherever you like
	$ge_token = $_SESSION['GE_token'] ?? NULL;
		 
	# Setup the GE class
	$ge = new \GE\GE($auth['username'], $auth['password'], $ge_token);

	# Initialize the GE class and get a bearer token in return
	$return_token = $ge->init();

	# Store the returned token to a $_SESSION or setup your own storage object
	$_SESSION['GE_token'] = $return_token;
	
	# Initialize the GE\User object
	$ge_user = new \GE\User();

	# Get user appliances
	$appl = $ge_user->get_appliances()[0];

	# Run commands on the appliance
	$appl->power_on();
	$appl->set_temperature(25);
?>

您可以在 /src/geAPI/commands/ac_commands.php 中查看 AC 类的所有可用函数和命令。