Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

Feature List

  • Kbox Basic Cloud Phone

    • Based on the Kunpeng server, it uses the closed-source Kbox and open-source AOSP software to build a cloud phone solution based on Android.

       

      Support for VMs: Based on the Docker container technology, the Kbox solution cannot be used on common VMs.

      • Android Kbox cloud phone container solution

        Kbox cloud phone container reference solution based on openEuler (host OS) and Android (guest OS).

        Supported OSs:

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints:The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Android 9.0 Kbox cloud phone container solution

        Kbox cloud phone container reference solution based on Ubuntu 20.04.3 (host OS) and Android 9.0 (guest OS).

        Supported OSs:

        • Host OS: Ubuntu 20.04.3
        • Guest OS: android-9.0.0_r55
        Constraints:The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Direct GPU rendering and mainstream graphics APIs

        Direct GPU rendering in containers, supporting OpenGL ES 2.0/3.0/3.1/3.2 and Vulkan 1.1 graphics APIs.

        Supported OSs:

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Hardware acceleration for video playback on cloud phones

        Hardware acceleration for video playback on cloud phones, implementing H.264 and H.265 decoding hardware acceleration for video playback, reducing CPU load, and improving performance in media scenarios.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Adaptive texture compression

        Adaptive texture compression based on the open source Mesa, supporting conversions of Vulkan RGB and RGBA textures to DXT textures.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Dynamic Kbox kernel switch

        Dynamic switch, enabling the host OS image used by the cloud phone to be shared by other services.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Adaptive frame synchronization

        Adaptive vertical synchronization (vsync), enabling SurfaceFlinger to compose one frame immediately after it is rendered and send it to the screen.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Android application compilation optimization

        ART DEX compilation optimization for Android applications to accelerate application startup.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4
        • Guest OS: android-11.0.0_r48
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • YCbCr_420_888 format

        YCbCr_420_888 supported by the Gralloc module, resolving the black screen issue.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4
        • Guest OS: android-11.0.0_r48
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Kbox dynamic frame rate adjustment

        Dynamic frame rate reduction when the client is disconnected from the cloud phone in the away from keyboard (AFK) scenario to cut rendering overhead.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Resource monitoring

        Monitoring GPU memory and other memory resources so that customers can perform operations based on resource usage.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Lightweight Android tailoring

        Removing unnecessary system services and built-in applications to reduce cloud phone resource usage, thereby improving system performance and optimizing user experience.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Android composer optimization

        When a game app is displayed in full screen and only the game app layer is present, the composition step can be skipped and image rotation from landscape to portrait can be omitted, reducing GPU overhead.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4     Guest OS: android-11.0.0_r48
        • Host OS：openEuler 24.03 LTS SP1                  Guest OS：android-15.0.r17
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.
      • Thread-level shader cache

        Pre-built binaries cut shader compilation and linking time, improving rendering efficiency of large-scale applications.

        Supported OSs: 

        • Host OS: openEuler 22.03 LTS SP1/SP3/SP4
        • Guest OS: android-11.0.0_r48
        Constraints: The closed source components need a request for commercial cooperation. The compatibility is subject to the baseline data. For new compatibility and requirements, please contact the customer manager.

      Kbox Cloud Phone Container Documentation 

  • Hardware Emulation

    • Based on software solutions, it emulates hardware functions of physical mobile phones to ensure that cloud phones and applications can be used properly.

      Support for VMs: Hardware emulation is supported only by the Docker-based Kbox cloud phone solution and cannot be performed on common VMs.

      • GPS Mock

        This feature injects predefined data (fixed GPS information, which cannot be dynamically changed) through the predefined interface of GPS mock, to ensure that upper-layer services can properly obtain the GPS information preset on the cloud phone.

        Supported OS:  android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: The emulated GPS information can be configured

      • Telephony mock

        This feature enables Telephony basic information for cloud phones through Telephony mock. It injects information such as IMEI provided by the user in advance into the cloud phone to ensure that upper-layer services can properly obtain the Telephony basic information preset in the cloud phone.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints:

        • Android 9 only supports IMEI, SIM, and phone number configurations. Other states of the SIM card are not supported.
        • Android 11 only supports IMEI, network carrier name, network carrier code, IMSI, SIM card carrier name, SIM card serial number, and mobile number configurations. Other SIM card states are not supported.
      • Wi-Fi Mock

        Wi-Fi mock (status mock) enables the Wi-Fi function on cloud phones by forwarding Wi-Fi traffic. Then upper-layer services can sense the Wi-Fi usage.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: Only SSID configuration and Wi-Fi status are supported. Other functions such as Wi-Fi enabling and disabling are not supported.

      • Acceleration Sensor Mock

        Acceleration Sensor Mock (status mock) enables the acceleration sensor function on cloud phones. Then upper-layer services can sense the acceleration.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: The emulated acceleration sensor data can be configured.

      • Gyroscope Mock

        Gyroscope Mock (status mock) enables the gyroscope function on cloud phones. Then upper-layer services can sense the gyroscope usage.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: The emulated gyroscope sensor data can be configured.

      • Emulation of multiple vinput devices

        The vinput device emulation function is provided to support the access of multiple peripherals on the Android set-top box (STB) and smart TV, such as the mouse, handle, and touch.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: Only one touch control, one mouse, and two handles are supported for input device emulation. By default, one touch control is supported.

      • Audio emulation

        Audio device emulation ensures that upper-layer services can properly invoke audio APIs.

        Supported OS: android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: This module can be used for audio emulation in scenarios where audio APIs are used.

  • Video Stream Engine

    • As the core engine in the video stream cloud phone solution, it supports core functions such as video encoding, video decoding and playing, and image screenshot of cloud phones, and encapsulates unified APIs to simplify secondary development.

      Support for VMs: The video stream engine runs only on Docker-based Kbox cloud phones and cannot be used on common VMs.

      • GPUs for Kunpeng servers

        This module enables GPUs to implement basic rendering capabilities and supports the 720p@30 fps/720p@60 fps/1080p@30 fps resolution and frame rate.

        For details about the supported GPU brands and models, consult the project contact person.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • 720p@30 fps/720p@60 fps/1080p@30 fps resolution and frame rates.
        • It is recommended that the ARM-based GPU driver be obtained and the porting and compilation guides be provided. The driver will be maintained by the customer.
      • Video stream server engine

        Video encoding, decoding, and screenshotting functions

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • H.264/H.265 video encoding and cloud phone screenshotting for the video stream server.
        • The engine startup management service and the communication channel between the cloud and mobile phones are customized by customers and ISVs.
      • Video stream client engine

        Adaptive decoding

        Supported OS: Android 8.x/9.x

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • H.264/H.265 decoding and playback.
        • Apps on phone terminals need to be customized by customers and ISVs based on their service requirements.
      • Optimized GPU stream output to reduce the latency

        GPU instructions are called in the image capture interface of the server to optimize the stream output and reduce the latency.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

      • Reduced load via rendering optimization on the primary and secondary screens

        The load of cloud phones is reduced and the density is improved by shielding invalid images, removing extended screens, and creating a streaming system.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

      • Frame interpolation

        When the image refresh rate is low (that is, no image is updated within 1/4 second), the frame interpolation function can be enabled to ensure that the average frame rate of output streams is higher than 28 fps.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: Closed source component, which needs a request for commercial cooperation.

      • Dynamic encoding resolution adjustment

        Dynamic resolution reduction, cutting bandwidth consumption and alleviating frame freezing.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: Closed source component, which needs a request for commercial cooperation.

      • 360p/480p resolution

        360p and 480p resolutions are supported to promote the expansion of cloud phone ToC services.

        Supported OS: android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints: Closed source component, which needs a request for commercial cooperation.

    Video Stream Engine Documentation

  • Instruction Stream Engine

    • As the core engine in the instruction stream cloud phone solution, it supports rendering of the entire cloud phone system and provides resolution-independent HD image display. It breaks through the GPU capability limitation on the cloud, runs rendering applications more efficiently, and significantly improves the concurrency density with better user experience at lower costs. In addition, it encapsulates unified APIs to simplify secondary development.

      Support for VMs: The instruction stream engine runs only on Docker-based Kbox cloud phones and cannot be used on common VMs.
      • System-wide instruction separation

        The instruction stream engine compresses and redirects OpenGL ES 2.0/3.0/3.1/3.2 and EGL 1.4 graphics rendering instructions/data of cloud phones (Android 9/11-based) from the server to the client. The graphics rendering instructions/data are asynchronously executed on the client.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48 (guest OS)

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • The engine startup management service and the communication channel between the cloud and mobile phones are customized by customers and ISVs.
      • Local rendering state machine

        The state machine is integrated on the server, allowing applications to run without GPUs (empty rendering).

        Supported OS: android-9.0.0_r55/android-11.0.0_r48 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

      • Rebuilding the rendering state machine

        This module enables rendering state machine rebuild and display on the client, and supports reconnection upon an interrupted connection. Users can access it at any time.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

      • Video streaming of texture data

        This module caches repeatedly used texture data and compresses and transmits OpenGL ES instructions, textures, and vertex data to reduce network traffic.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48 (guest OS)

        Constraints: Closed source component, which needs a request for commercial cooperation.
      • Resolution awareness and adaptation

        A cloud phone can automatically adjust the screen resolution based on the screen resolution of the corresponding mobile phone to ensure that the screen resolution of the server is the same as that of the client.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

      • HD 1080p@30 fps display

        The instruction stream engine allows cloud phones to run in 1080p@30 fps by default.

        Supported OS: android-9.0.0_r55/android-11.0.0_r48 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

      • Media playback optimization

        The optimization supports hardware decoding of media cards and asynchronous encoding/streaming to improve the frame rate and user experience in video playback scenarios.

        Supported OS: android-11.0.0_r48 (guest OS)

        Constraints: closed source component, which needs a request for commercial cooperation.

    Instruction Stream Engine Documentation

  • Basic Engine

    • The base engine provides the touch engine and audio engine. The touch engine enables server-side cloud phones to identify touch operations on client-side physical phones. The audio engine enables client-side physical phones to play audio data generated on server-side cloud phones.

      Support for VMs: The base engine runs only on Docker-based Kbox cloud phones and cannot be used on common VMs.

      • Server-side audio capture engine

        Server-side audio engine for capturing engine data

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • The engine startup management service and the communication channel between the cloud and mobile phones are customized by customers and ISVs.
      • Client-side audio playback engine

        Client-side audio engine for audio playback

        Supported OSs: Android 7 and later

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • Apps on phone terminals need to be customized by customers and ISVs based on their service requirements.
      • Server-side control engine

        Server-side control engine for injecting control commands obtained from the client

        Supported OS: android-9.0.0_r55/android-11.0.0_r48/android-15.0.r17 (guest OS)

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • The engine startup management service and the communication channel between the cloud and mobile phones are customized by customers and ISVs.
      • Client-side control engine

        Client-side control engine for capturing touch operations

        Supported OSs: Android 7 and later

        Constraints:
        • Closed source component, which needs a request for commercial cooperation.
        • Apps on phone terminals need to be customized by customers and ISVs based on their service requirements.

  • ExaGear AArch32 Instruction Translation

    • The ExaGear AArch32 instruction translation software provides the AArch32 feature for Kunpeng servers. The servers are therefore fully compatible with AArch32 V8.0 instruction applications.

      Supported OSs: 

      • Host OS: Ubuntu 20.04.3 (kernel 5.4.30/5.10.27/5.15.98)      Guest OS: android-9.0.0_r55/android-11.0.0_r48
      • Host OS: openEuler 22.03 LTS (kernel 5.10.0)                        Guest OS: android-11.0.0_r48
      • Host OS：openEuler 24.03 LTS SP1（kernel 6.6.0-72.0.0）   Guest OS：android-15.0.r17
      Constraints: closed source component, which needs a request for commercial cooperation.
      Support for VMs: Currently, ExaGear can run only on QEMU-based and Docker-based cloud phones, and cannot be used on common VMs.
      • ARM32-ARM64 instruction translation
        It supports ARM 32 instruction translation and is adapted to the new kernel and Android versions.

        Software Package

        View Document
      • Compatibility enhancement
        It enhances the compatibility of 32-bit instruction translation and completes compatibility tests of top apps.