Cloud Phone:Edisi Windows SDK C++

Unduh SDK dan demo

Kebutuhan lingkungan integrasi

Rilis Windows x64

Mengimpor SDK

Contoh Visual Studio 2019:

Buka Project Properties > Configuration Properties > VC++ Directories. Tambahkan direktori include asp-client-sdk ke Include Directories.

Buka Project Properties > Configuration Properties > VC++ Directories. Tambahkan direktori lib asp-client-sdk ke Library Directories.

Buka Project Properties > Configuration Properties > Linker > General. Tambahkan direktori lib asp-client-sdk ke Additional Library Directories.

Buka Project Properties > Configuration Properties > Linker > Input. Tambahkan asp-client-sdk.lib, asp-engine.lib, dan glog.lib ke Additional Dependencies.

Contoh Qt Creator:

Tambahkan baris berikut ke file .pro proyek Anda:

INCLUDEPATH+=$$PWD/asp-client-sdk/include \
LIBS+=$$PWD/asp-client-sdk/lib/asp-client-sdk.lib \
      $$PWD/asp-client-sdk/lib/asp-engine.lib \
      $$PWD/asp-client-sdk/lib/glog.lib \

Jalankan demo dengan cepat

Unduh Windows_Demo_Release dan ekstrak untuk mendapatkan dua direktori: server dan client. Direktori ini masing-masing berisi demo sisi server dan sisi client.

Jalankan server

Ubah file konfigurasi:

{
    "httpPort": "8328",
    "accessKeyId": "AK",
    "accessKeySecret": "SK",
    "androidRegionId": "cn-hangzhou"
}

Ganti AK dan SK dengan ID AccessKey dan AccessKey Secret Anda yang sebenarnya. Atur androidRegionId ke ID wilayah instans Anda.

Jalankan server/run_server.bat. Pesan berikut akan muncul:

2024-11-01T13:48:27.002Z Server is running on http://127.0.0.1:8328/listAic

Server telah berhasil dijalankan.

Jalankan client

{
  "CLOUD_SCREENSIZE_HEIGHT": 100,
  "CLOUD_SCREENSIZE_WIDTH": 100,
  "DEBUG_MODE": 2,
  "DISPLAY_COL": 11,
  "DISPLAY_GROUP": 20,
  "GROUPIDS": [
       "ag-1jknz4zyznleim503"
  ],
  "GROUP_SCREENSIZE_HEIGHT": 100,
  "GROUP_SCREENSIZE_WIDTH": 100,
  "LOCAL_SCREENSIZE_HEIGHT": 720,
  "LOCAL_SCREENSIZE_WIDTH": 480,
  "DISPLAY_SCALE": 1,
  "GROUP_SCALE": 8,
  "MAX_PHONE_NUM": 0,
  "PROXY_CONN_TYPE": 0,
  "QUIC_OPTION": false,
  "PHONE_URL": "http://127.0.0.1",
  "PORT": 8328,
  "AUDIO_ENABLE": false,
  "USE_DUMP": false,
  "USE_OPENGL": true
}

Ganti GROUPIDS dengan ID grup instans Cloud Phone yang ingin Anda kendalikan. ID tersebut harus diawali dengan ag-. Anda dapat menentukan beberapa ID grup. Simpan file setelah memperbaruinya dengan ID grup instans Cloud Phone berawalan ag- Anda.

Deskripsi parameter konfigurasi:

CLOUD_SCREENSIZE_HEIGHT: Tinggi awal layar cloud
CLOUD_SCREENSIZE_WIDTH: Lebar awal layar cloud
DEBUG_MODE: Tingkat log (0 = tanpa log, 1 = debug, 2 = info)
DISPLAY_COL: Jumlah maksimum kolom yang ditampilkan (10)
GROUPIDS: Grup instans (mendukung daftar)
GROUP_SCREENSIZE_HEIGHT: Tinggi awal jendela gambar mini lokal
GROUP_SCREENSIZE_WIDTH: Lebar awal jendela gambar mini lokal
LOCAL_SCREENSIZE_HEIGHT: Tinggi awal jendela kontrol utama lokal
LOCAL_SCREENSIZE_WIDTH: Lebar awal jendela kontrol utama lokal
DISPLAY_SCALE: Rasio penskalaan kontrol utama
GROUP_SCALE: Rasio penskalaan gambar mini
MAX_PHONE_NUM: Jumlah maksimum koneksi
PROXY_CONN_TYPE: Jenis koneksi (nilai tetap)
QUIC_OPTION: Apakah menggunakan QUIC (nilai tetap)
PHONE_URL: Alamat server
PORT: Port server
AUDIO_ENABLE: Apakah audio diaktifkan
EndUserId: Username streaming kolaboratif
IS_COO: Apakah streaming kolaboratif diaktifkan
SALE_MODE: Apakah CPS diaktifkan
SHOW_INSTENCE_NAME: Apakah nama atau ID instans ditampilkan
USE_OPENGL: Apakah rendering OpenGL diaktifkan

Jalankan client/WuyingDemo.exe.

2.5.1 Proxy callback koneksi IAspClientCallback

Deskripsi antarmuka proxy:

Contoh kode:

class AspClientCbImpl : public IAspClientCallback
{
public:
    AspClientCbImpl() {}
    // Callback pembaruan gambar mini
    void onThumbnailUpdate(void* buffer, uint32_t width, uint32_t height, AspImageFormat format) override {

    }
    // Callback event koneksi
    void onConnectEvent(ConnectEvent& event) override {
       switch(event.type) {
          case ConnectEventType::EVENT_CONNECT_SUCCESS:
              
              break;
          case ConnectEventType::EVENT_CONNECT_FAILED:
              
              break;
          case ConnectEventType::EVENT_DISCONNECT_SUCCESS:
              
              break;
          case ConnectEventType::EVENT_RECONNECT_START:
              
              break;
          case ConnectEventType::EVENT_RECONNECT_FAILED:
              
              break;
          default:
              
              break;
        }
    }
};

2.5.2 Proxy callback aliran kontrol utama IAspDisplayCallback

Deskripsi antarmuka proxy:

Contoh kode:

class AspDisplayCbImpl : public IAspDisplayCallback
{
public:
    void onImageFrameReady(AspImageFrame& frame) override {
        // Pointer ke array byte gambar kontrol utama (panjang = lebar × tinggi × 4)
        uint8_t* ptr = static_cast<uint8_t*>(frame.buffer);
        // Lebar gambar
        int width = frame.width;
        // Tinggi gambar
        int height = frame.height;
        // Harus dilepas secara manual
        frame.releaseBuffer();
    }
};

2.5.3 Proxy callback audio AspAudio

Deskripsi antarmuka proxy:

Contoh kode:

class AspAudioImpl : public AspAudio
{
public:
    void onAudioFrameRender(AspAudioFrame &frame) override{
    
    }
    void onAudioVolumeUpdate(uint32_t volume) override{
    
    }
    void onAudioMuteUpdate(bool isMute) override{
    
    }

    void onAudioPlaybackUpdate(AspAudioPlayback &playback) override{
    
    }

    void onAudioPlaybackStart() override{
    
    }
    void onAudioPlaybackStop() override{
    
    }
};

3.1.1 Inisialisasi

Deskripsi fungsi: Antarmuka ini mencetak log internal SDK untuk troubleshooting.

Contoh kode:

// Inisialisasi logging. AspLogSinkImpl adalah callback log.
auto logSinkImpl = std::make_shared<AspLogSinkImpl>();
AspLogSink::setLogSink(logSinkImpl.get());

3.1.2 Proxy callback AspLogSink

Deskripsi antarmuka proxy:

Contoh kode:

#include "AspLogSink.h"

using namespace wuying::asp;

class AspLogSinkImpl : public AspLogSink
{
public:
    AspLogSinkImpl() {

    }

    void debug(const std::string& tag, const std::string& msg) override {
        // Cetak log debug
    }
    void info(const std::string& tag, const std::string& msg) override {
        // Cetak log info
    }
    void warning(const std::string& tag, const std::string& msg) override {
        // Cetak log warning
    }
    void fatal(const std::string& tag, const std::string& msg) override {
        // Cetak log fatal
    }
    void error(const std::string& tag, const std::string& msg) override {
        // Cetak log error
    }
};

3.2.1 suspendThumbnailDisplay

Prototipe fungsi: void suspendThumbnailDisplay() 

Deskripsi fungsi: Menangguhkan streaming gambar mini.

Contoh kode:

client->suspendThumbnailDisplay();

3.2.2 resumeThumbnailDisplay

Prototipe fungsi: void resumeThumbnailDisplay() 

Deskripsi fungsi: Melanjutkan streaming gambar mini dan dapat memaksa mendorong satu frame.

Contoh kode:

client->resumeThumbnailDisplay();

3.3.1 setOutputImageFormat

Prototipe fungsi: void setOutputImageFormat(AspImageFormat format)

Deskripsi fungsi: Mengatur format frame callback kontrol utama.

Deskripsi parameter:

Contoh kode:

client->setOutputImageFormat(AspImageFormat::BGRA);

3.3.2 requestGraphicsKeyFrame

Prototipe fungsi: void requestGraphicsKeyFrame(AspDisplay* display) = 0;

Deskripsi fungsi: Mendorong satu keyframe untuk aliran kontrol utama. Parameter adalah AspDisplay.

Deskripsi parameter:

Contoh kode:

client->requestGraphicsKeyFrame(display);

3.3.3 setGraphicsQuality

Prototipe fungsi: void setGraphicsQuality(AspImageQuality quality) = 0;

Deskripsi fungsi: Mengatur kualitas gambar. Kualitas bergantung pada resolusi. Secara umum, atur parameter ini ke AUTO. Untuk parameter terperinci, lihat definisi struct.

Deskripsi parameter:

client->setGraphicsQuality(ASP_IMAGE_QUALITY_AUTO)

3.3.4 setGraphicsFps

Prototipe fungsi: void setGraphicsFps(int fps) = 0；

Deskripsi fungsi: Mengatur frame per detik (FPS).

Deskripsi parameter:

Contoh kode:

client->setGraphicsFps(30)

3.3.5 setGraphicsBitrate

Prototipe fungsi: void setGraphicsBitrate(int32_t bps) = 0;

Deskripsi fungsi: Mengatur bitrate, yang memengaruhi ukuran gambar.

Deskripsi parameter:

Bitrate berikut hanya sebagai referensi:

Contoh kode:

client->setGraphicsBitrate(1*1024)

3.4.1 sendMouseClick

Prototipe fungsi: void sendMouseClick(AspAction action, uint32_t button, uint32_t buttonState) = 0;

Deskripsi fungsi: Mengirim event klik mouse.

Deskripsi parameter:

Contoh kode:

// Tekan tombol kiri mouse
display->sendMouseClick(AspAction::ACTION_DOWN, ASP_MOUSE_BUTTON_MASK_L, ASP_MOUSE_BUTTON_LEFT);
// Lepas tombol kiri mouse
display->sendMouseClick(AspAction::ACTION_UP, ASP_MOUSE_BUTTON_MASK_L, ASP_MOUSE_BUTTON_LEFT);

3.4.2 sendMouseMove

Prototipe fungsi: virtual void sendMouseMove(uint32_t x, uint32_t y, uint32_t buttonState) = 0;

Deskripsi fungsi: Mengirim event gerakan mouse.

Deskripsi parameter:

Contoh kode:

// x dan y adalah koordinat Cloud Phone
sendMouseMove(x, y, ASP_MOUSE_BUTTON_MASK_L)

3.5.1 sendKeyEvent

Prototipe fungsi: virtual void sendKeyEvent(AspAction action, int scancode) = 0;

Fitur ini menjelaskan event keyboard.

Deskripsi parameter:

Contoh kode:

// Tekan tombol
display->sendKeyEvent(AspAction::ACTION_DOWN,scanCode);
// Lepas tombol
display->sendKeyEvent(AspAction::ACTION_UP,scanCode);

3.6.1 setClipBoardTypes

Prototipe fungsi: virtual void setClipBoardTypes(std::vector<AspClipboardType> types) = 0;

Mengirim format data konten clipboard saat Anda menyalin ke clipboard atau menempel dengan menekan Ctrl+V. Hanya teks yang didukung.

Deskripsi parameter:

Contoh kode:

std::vector<AspClipboardType> types;
types.push_back(AspClipboardType::CLIPBOARD_UTF8_TEXT);
client->setClipBoardTypes(types);

3.6.2 notifyClipboardReadComplete

Prototipe fungsi: virtual void notifyClipboardReadComplete(AspClipboardType type, uint8_t* buf, size_t len) = 0;

Deskripsi fungsi: Mengirim konten ke Cloud Phone. Fungsi ini dipanggil saat onClipboardRead(uint8_t selection, AspClipboardType type) dipicu.

Deskripsi parameter:

Contoh kode:

void onClipboardRead(uint8_t selection, AspClipboardType type) override {
        // Dipicu saat menyalin dari lokal ke Cloud Phone melalui client->setClipBoardTypes(types)
        // Panggil notifyClipboardReadComplete untuk mengirim konten clipboard
        client->notifyClipboardReadComplete(type, reinterpret_cast<uint8_t *>(utf8Data.data()), utf8Data.size());
}

3.6.3 Proxy callback IClipboardCallback

Deskripsi antarmuka proxy:

Contoh kode:

class AspClipboardlmpl :public IClipboardCallback
{
public:
    AspClipboardlmpl() {};

    void onClipboardRead(uint8_t selection, AspClipboardType type) override {
        // Dipicu saat menyalin dari lokal ke Cloud Phone melalui client->setClipBoardTypes(types)
        // Panggil notifyClipboardReadComplete untuk mengirim konten clipboard
        //client->notifyClipboardReadComplete(type, reinterpret_cast<uint8_t *>(utf8Data.data()), utf8Data.size());
    }
    void onClipboardWrite(std::vector<AspClipboardData> dataV) override {
        // Tulis dataV ke clipboard lokal saat menyalin dari Cloud Phone
    }
};

3.7.1 sendStringDataToShell

Prototipe fungsi: virtual bool sendStringDataToShell(const std::string& val) = 0;

Deskripsi fungsi: Mengirim perintah Shell.

Deskripsi parameter:

Contoh kode:

client->sendStringDataToShell(jsonString)

Perintah ADB umum:

3.7.2 Proxy callback IShellCmdCallback

Deskripsi antarmuka proxy:

Contoh kode:

class AspShellCmdlmpl :public IShellCmdCallback
{
public:
    AspShellCmdlmpl() {};

    void onReceiveStringData(const std::string& val) override {
        // Callback untuk tanggapan string
    }
    void onReceiveRawData(const std::vector<uint8_t> val) override {
       // Callback untuk tanggapan byte mentah
    }
};