System Service API (AIDL) | VMOS Cloud API

Interface Method Descriptions

ControlInterface.java (Control Utility Class)

1. `void isOpenGms(boolean isOpen)`

Description: Enables or disables Google Mobile Services (GMS).

Parameter	Type	Description
`isOpen`	`boolean`	`true` enables GMS, `false` disables it.

2. `void sendMessage(String message)`

Description: Sends a message.

Parameter	Type	Description
`message`	`String`	The message content to be sent.

3. `void setGpsLocation(double latitude, double longitude)`

Description: Sets the GPS location.

Parameter	Type	Description
`latitude`	`double`	Latitude value (between -90 and 90).
`longitude`	`double`	Longitude value (between -180 and 180).

4. `void setFrame(int width, int height)`

Description: Adjusts screen resolution.

Parameter	Type	Description
`width`	`int`	Screen width.
`height`	`int`	Screen height.

5. `void openProxyUser(String ip, int port, String account, String password, String proxyType, String proxyName)`

Description: Activates a proxy with username and password authentication.

Parameter	Type	Description
`ip`	`String`	Proxy server IP address.
`port`	`int`	Proxy server port number.
`account`	`String`	Proxy username.
`password`	`String`	Proxy password.
`proxyType`	`String`	Proxy type (e.g., `proxy`, `vpn`).
`proxyName`	`String`	Proxy name (e.g., `http-relay`, `socks5`).

6. `void openProxy(String ip, int port, String proxyType, String proxyName)`

Description: Activates a proxy without requiring user authentication.

Parameter	Type	Description
`ip`	`String`	Proxy server IP address.
`port`	`int`	Proxy server port number.
`proxyType`	`String`	Proxy type (e.g., `proxy`, `vpn`).
`proxyName`	`String`	Proxy name (e.g., `http-relay`, `socks5`).

7. `void setProxyPassPackageName(String packageName)`

Description: Sets the application package name to bypass the proxy.

Parameter	Type	Description
`packageName`	`String`	Package name of the app to bypass proxy.

8. `void closeProxy()`

Description: Terminates the current proxy connection.

9. `void startCameraVideo(String path, boolean isLoop)`

Description: Starts injecting a camera video.

Parameter	Type	Description
`path`	`String`	Path where the video file is stored.
`isLoop`	`boolean`	`true` for loop playback, `false` otherwise.

10. `void stopCameraVideo()`

Description: Stops camera video recording.

11. `List<String> getProxyPassPackageName()`

Description: Retrieves a list of application package names that bypass the proxy.

Return Value	Type	Description
List	`List<String>`	List of package names bypassing the proxy.

12. `void startImage(String path)`

Description: Loads and displays an image.

Parameter	Type	Description
`path`	`String`	Path to the image file.

RootInterface.java (Root Utility Class)

1. `void allRoot(boolean isRoot)`

Description: Toggles global root access.

Parameter	Type	Description
`isRoot`	`boolean`	`true` enables global root access, `false` disables it.

2. `void setRootPackageName(String packageName, boolean isRoot)`

Description: Toggles root access for a specific application package.

Parameter	Type	Description
`packageName`	`String`	Application package name.
`isRoot`	`boolean`	`true` enables, `false` disables root access.

3. `boolean isRoot(String packageName)`

Description: Checks if a specific application package has root access.

Parameter	Type	Description
`packageName`	`String`	Application package name.

Return Value	Type	Description
Return Value	`boolean`	`true` if the app has root access, `false` otherwise.

4. `boolean isAllRoot()`

Description: Checks if global root access is enabled.

Return Value	Type	Description
Return Value	`boolean`	`true` if global root access is enabled, `false` otherwise.

Real Machine Message Forwarding to Cloud Machine

Add MessageInterface.aidl file to aidl.cloud.api.server directory.
Create a Service that extends MessageInterface.Stub() and implement the message method in the interface.

1. `void message(int type, String data)`

Description: Message forwarding.

Parameter	Type	Description
`type`	`int`	Message type.
`data`	`String`	Message content.

Fetching Backend-Assigned Task Download Progress

1. `void apkDownloaderEnd(String packageName, String appName, long taskId)`

Description: Notifies the end of an APK download task.

Parameter	Type	Description
`packageName`	`String`	Application package name.
`appName`	`String`	Application name.
`taskId`	`long`	Unique identifier for the task.

2. `void apkDownloadStart(String packageName, String iconUrl, String appName, long taskId, String path)`

Description: Notifies the start of an APK download task.

Parameter	Type	Description
`packageName`	`String`	Application package name.
`iconUrl`	`String`	URL of the application icon.
`appName`	`String`	Application name.
`taskId`	`long`	Unique identifier for the task.
`path`	`String`	Storage path for the downloaded APK.

3. `void apkProgress(String packageName, int progress)`

Description: Notifies APK download progress.

Parameter	Type	Description
`packageName`	`String`	Application package name.
`progress`	`int`	Current download progress (0–100).

4. `void apkDownloadFail(String packageName)`

Description: Notifies APK download failure.

Parameter	Type	Description
`packageName`	`String`	Application package name.

Note: Usually, progress is integrated with the launcher package name com.android.mxLauncher3. For other package names, contact business support or customer service for customization.