Menggunakan AppStream 2.0 Dynamic Application Framework untuk Membangun Penyedia Aplikasi Dinamis

Framework aplikasi dinamis AppStream 2.0 menyediakan operasi API dalam instance streaming AppStream 2.0 yang dapat Anda gunakan untuk membangun penyedia aplikasi dinamis. Penyedia aplikasi dinamis dapat menggunakan operasi API yang disediakan untuk memodifikasi katalog aplikasi yang dapat diakses pengguna Anda secara real time. Aplikasi yang dikelola oleh penyedia aplikasi dinamis dapat berada di dalam gambar, atau mereka dapat di luar instance, seperti dari berbagi file Windows atau teknologi virtualisasi aplikasi.

catatan

Fitur ini memerlukan armada AppStream 2.0 Always-On atau On-Demand yang digabungkan ke domain Microsoft Active Directory. Untuk informasi selengkapnya, lihat Menggunakan Active Directory dengan AppStream 2.0.

Tentang Kerangka Aplikasi Dinamis

Kerangka kerja aplikasi dinamis menggunakan kerangka kerja perangkat lunak Apache Thrift untuk pengiriman pesan antar-proses. Itu diekspos melalui Pipa Bernama di Windows. Menggunakan kerangka kerja Thrift memungkinkan Anda untuk membangun penyedia aplikasi dinamis Anda dalam bahasa pengembangan perangkat lunak pilihan Anda. Kerangka kerja aplikasi dinamis terdiri dari tiga operasi API:AddApplications,RemoveApplications, danClearApplications.

Definisi Penghematan Kerangka Aplikasi Dinamis dan Nama Pipa Bernama

Thrift memungkinkan Anda untuk menggunakan file definisi sederhana yang disediakan oleh AppStream 2.0 untuk mengkompilasi klien RPC. Klien RPC memungkinkan Anda berkomunikasi dengan perangkat lunak agen AppStream 2.0 yang berjalan pada instance streaming. Untuk informasi tentang cara mengkompilasi klien RPC untuk bahasa Anda, lihat dokumentasi Apache Thrift. Setelah Anda mengkompilasi perpustakaan Thrift untuk bahasa pilihan Anda, buat klien Thrift dengan menggunakan transportasi Pipa Bernama. Gunakan D56C0258-2173-48D5-B0E6-1EC85AC67893 sebagai nama pipa.

AppStreamServer.penghematan

namespace netstd AppStream.ApplicationCatalogService.Model

const string ServiceEndpoint = "D56C0258-2173-48D5-B0E6-1EC85AC67893";


struct AddApplicationsRequest
{
    1: required string userSid;
    2: required list<Application> applications;
}

struct AddApplicationsResponse
{
}

struct RemoveApplicationsRequest
{
    1: required string userSid; 
    2: required list<string> applicationIds;
}

struct RemoveApplicationsResponse
{
}

struct ClearApplicationsRequest
{
    1: required string userSid; 
}

struct ClearApplicationsResponse
{
}

struct Application
{
    1: required string id;
    2: required string displayName;
    3: required string launchPath;
    4: required string iconData;
    5: string launchParams;
    6: string workingDirectory;
}

exception AppStreamClientException
{
    1: string errorMessage,
    2: ErrorCode errorCode
}
	  
exception AppStreamServerException
{
    1: string errorMessage,
    2: ErrorCode errorCode
}

enum ErrorCode
{
}

service ApplicationCatalogService
{
    AddApplicationsResponse AddApplications(1:AddApplicationsRequest request)
    throws (1: AppStreamClientException ce, 2: AppStreamServerException se),

    RemoveApplicationsResponse RemoveApplications(1:RemoveApplicationsRequest request)
    throws (1: AppStreamClientException ce, 2: AppStreamServerException se),

    ClearApplicationsResponse ClearApplications(1:ClearApplicationsRequest request)
    throws (1: AppStreamClientException ce, 2: AppStreamServerException se),
}

Tindakan API untuk Mengelola Hak Aplikasi untuk 2.0 AppStream

Anda dapat menggunakan operasi API berikut untuk mengelola hak aplikasi untuk AppStream 2.0.

Operasi AddApplicationsRequest

Menambahkan aplikasi ke katalog aplikasi untuk pengguna AppStream 2.0. Katalog aplikasi yang ditampilkan oleh AppStream 2.0 mencakup aplikasi yang Anda tambahkan dengan menggunakan operasi API ini dan aplikasi yang Anda tambahkan dalam gambar. Setelah Anda menambahkan aplikasi dengan menggunakan salah satu atau kedua metode ini, pengguna Anda dapat meluncurkan aplikasi.

Minta sintaks

string userSid;

list<Application> applications;

Parameter permintaan

UserSid

SID pengguna yang permintaannya berlaku.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 208 karakter.

aplikasi

Daftar aplikasi yang berlaku untuk permintaan tersebut.

Tipe: String

Wajib: Ya

Objek Application

Menjelaskan metadata aplikasi yang diperlukan untuk menampilkan dan meluncurkan aplikasi. Pengenal aplikasi harus unik dan tidak bertentangan dengan aplikasi lain yang ditentukan melalui operasi API atau gambar.

id

Pengidentifikasi aplikasi yang ditentukan. Nilai ini, yang sesuai dengan application_name nilai dalam laporan aplikasi AppStream 2.0, diberikan saat pengguna meluncurkan aplikasi. Saat Anda mengaktifkan laporan penggunaan, untuk setiap hari pengguna meluncurkan setidaknya satu aplikasi selama sesi streaming mereka, AppStream 2.0 mengekspor laporan aplikasi ke bucket Amazon S3 Anda. Untuk informasi selengkapnya tentang laporan aplikasi, lihatBidang Laporan Aplikasi.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 512 karakter.

DisplayName

Nama tampilan aplikasi yang ditentukan. Nama ini ditampilkan kepada pengguna di katalog aplikasi.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 512 karakter.

LaunchPath

Jalur sistem file Windows ke executable aplikasi yang akan diluncurkan.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 32.767 karakter.

IconData

Gambar yang dikodekan basis-64 untuk ditampilkan dalam katalog aplikasi. Gambar harus dalam salah satu format berikut: .png, .jpeg, atau .jpg.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 1.000.000 karakter.

LaunchParams

Parameter yang digunakan untuk meluncurkan aplikasi.

Tipe: String

Wajib: Tidak

Kendala panjang: Panjang maksimum 32.000 karakter.

WorkingDirectory

Jalur sistem file Windows ke direktori kerja tempat aplikasi harus diluncurkan.

Tipe: String

Wajib: Tidak

Kendala panjang: Panjang maksimum 32.767 karakter.

Operasi RemoveApplicationsRequest

Menghapus aplikasi yang ditambahkan dengan menggunakan AddApplicationsRequest operasi. Aplikasi dihapus dari katalog aplikasi untuk pengguna. Setelah aplikasi dihapus, mereka tidak dapat diluncurkan. Jika aplikasi masih berjalan, AppStream 2.0 tidak menutupnya. Aplikasi yang ditentukan langsung dalam gambar AppStream 2.0 tidak dapat dihapus.

Minta sintaks

string userSid;

list<Application> applications;

Parameter permintaan

UserSid

SID pengguna permintaan berlaku untuk.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 208 karakter.

aplikasi

Daftar aplikasi yang berlaku untuk permintaan tersebut.

Tipe: String

Wajib: Ya

Operasi ClearApplicationsRequest

Menghapus semua aplikasi yang ditambahkan ke katalog aplikasi dengan menggunakan AddApplicationsRequest operasi. Setelah aplikasi dihapus, mereka tidak dapat diluncurkan. Jika aplikasi berjalan saat ClearApplicationsRequest operasi digunakan, AppStream 2.0 tidak menutupnya. Aplikasi yang ditentukan langsung dalam gambar AppStream 2.0 tidak dapat dihapus.

Minta sintaks

string userSid;

Parameter permintaan

UserSid

SID pengguna permintaan berlaku untuk.

Tipe: String

Wajib: Ya

Kendala panjang: Panjang minimum 1, panjang maksimum 208 karakter.