closeApp: Close the software

Function Description:

Close specified software on the device.

Corresponding JS API:

closeApp(packageName)

Whether to support multiple devices:

Yes

Resource Information:

Method Parameters:

Response Parameters:

A JSON string representing an array of objects with the following fields:

Request Example:

http://localhost:8090/TotalControl/v1/devices/device@1116106541/apps/com.tencent.qqmusic?token=270eq7lXQK8bXYsJ&state=inactive

Response Example:

If this API executes successfully, it returns:

{
    "status": true,
    "value": "make it inactive"
}

If the value of HTTP status code is 200, but the value of status is a null object, it returns:

{
    "status": null,
    "value": "<Error message>"
}

Example:

Close the QQ music software.

Warm tip:
Get the token needed for Total Control script development,see here.
Get the id value of the master device, see here.

RingoJS Example:

// Import the packages
var {request} = require('ringo/httpclient');
var base64 = require('ringo/base64');

appName = "com.tencent.qqmusic"
// The username and password are separated by a single : and sent on the wire base64 encoded
var userpass = base64.encode('sigma:3D391497');

// First step: Get the API token
var gettoken = request({
	method: 'GET',
	url: 'http://localhost:8090/TotalControl/v1/login',
	headers: {
		'Authorization': userpass
	}
});
var ret_token = JSON.parse(gettoken.content).value; 
var token = ret_token.token; 
print("//The value of token is:" + token);

// Second step: Get the device id value of the master device
var getdevice = request({
	method: 'GET',
	url: 'http://localhost:8090/TotalControl/v1/devices/main?token=' + token
});
var device = JSON.parse(getdevice.content).id;
print("//The value of device ID is:"+ device);

// Third step: Execute this REST API
var ret = request({
	method: 'POST',
	url: 'http://localhost:8090/TotalControl/v1/devices/' + device + '/apps/' + appName,
	data: {
		'token': token,
		'state': 'inactive'
	}
});
print("//Executed successfully,Return value: \n"+ret.content);

The running result of the RingoJS:

If it executes successfully, it will return:

//The value of token is:O9KT30XV6gOthDZD
//The value of device ID is:device@33254183
//Executed successfully,Return value: 
{"status":true,"value":"make it inactive."}

Python Example:

#!/user/bin/python
#-*- coding:utf-8 -*-
import base64
import requests

appName = "com.tencent.qqmusic"
# The username and password are separated by a single : and sent on the wire base64 encoded
user_pass = 'sigma:3D391497'
encodeStr = base64.b64encode(user_pass.encode("UTF-8"))

# First step: Get the API token
LoginUrl = "http://localhost:8090/TotalControl/v1/login"
response = requests.get(LoginUrl, headers={'Authorization':encodeStr})
print("Get the token,Return value: ",response.json())
token = response.json()['value']['token']
print("The value of token is: ",token)

# Second step: Get the device id value of the master device
if token is not None:
    GetDeviceUrl = "http://localhost:8090/TotalControl/v1/devices/main?token=" + token
    response = requests.get(url=GetDeviceUrl)
    print("Get the device id,Return value: ", response.json())
    device = response.json()['id']
    print("The value of device id is: ", device)
    if device is not None:
        # Third step: Execute this REST API
        APIUrl = "http://localhost:8090/TotalControl/v1/devices/" + device + "/apps/" + appName
        data = {
            "state": "inactive",
            "token": token
        }
        response = requests.post(url=APIUrl, params=data)
        ret = response.json()['status']
        # Determine if this REST API is executed successfully
        if ret is True:
            print("Executed successfully,Return value: ", response.json())
        elif response.status_code == 200 and ret is not True:
            print("An error message is returned: ",response.json())
        else:
            print("This API failed to execute.")
    else:
        print("Failed to get device id.")
else:
    print("Failed to get token.")

The running result of the python:

If it executes successfully, it will return:

Get the token,Return value:  {'status': True, 'value': {'token': 'O9KT30XV6gOthDZD'}}
The value of token is:  O9KT30XV6gOthDZD
Get the device id,Return value:  {'id': 'device@33254183'}
The value of device id is:  device@33254183
Executed successfully,Return value:  {'status': True, 'value': 'make it inactive.'}