Bagikan melalui

Tindakan Aplikasi di Gambaran Umum Windows

Tindakan Aplikasi di Windows adalah unit perilaku individual yang dapat diterapkan dan didaftarkan aplikasi Windows sehingga dapat diakses dari aplikasi dan pengalaman lain, terintegrasi dengan mulus ke dalam alur kerja pengguna.

Apa itu Tindakan Aplikasi?

Tindakan Aplikasi adalah satuan fungsionalitas terkecil. Aplikasi membangun dan mendaftarkan tindakan, lalu Windows atau aplikasi lain dapat merekomendasikan tindakan terdaftar kepada pengguna pada waktu dan lokasi yang relevan secara kontekstual dalam alur kerja pengguna. 

Implementasi App Action

Tindakan dapat diimplementasikan dengan menangani aktivasi peluncuran URI, atau dengan melalui aktivasi COM dengan menerapkan antarmuka IActionProvider . Untuk panduan penerapan penyedia tindakan aplikasi sederhana menggunakan aktivasi URI, lihat Mulai menggunakan Tindakan Aplikasi di Windows.

Aplikasi harus memiliki identitas paket untuk mendaftarkan tindakan aplikasi. Manifes paket MSIX menyediakan metadata tentang tindakan yang didukung oleh aplikasi penyedia. Untuk informasi selengkapnya tentang sintaks manifes paket aplikasi untuk pendaftaran App Action, lihat actions-provider-manifest.md.

Tindakan didefinisikan menggunakan format JSON yang menyediakan metadata tentang satu atau beberapa tindakan, yang mencakup informasi seperti pengidentifikasi dan deskripsi unik untuk tindakan serta daftar input dan output yang dioperasikan tindakan. File definisi tindakan JSON dipaketkan dengan aplikasi penyedia sebagai konten. Jalur ke file dalam paket ditentukan dalam manifes paket aplikasi sehingga sistem dapat menemukan dan menyerap definisi tindakan. Untuk informasi selengkapnya tentang format JSON untuk mendeklarasikan tindakan, lihat Skema JSON definisi tindakan untuk penyedia Tindakan Aplikasi Windows.

Entitas adalah objek yang dioperasikan oleh Tindakan Aplikasi. Tindakan mengambil entitas sebagai input dan dapat mengembalikan entitas sebagai output. Entitas dibagi menjadi subjenis untuk mewakili berbagai jenis konten yang dapat dioperasikan oleh tindakan, seperti Dokumen, Foto, dan Teks. Setiap jenis entitas memiliki sekumpulan properti yang menyediakan informasi yang terkait dengan setiap jenis konten, seperti jalur atau ekstensi file file. Entitas dinyatakan sebagai JSON dalam file JSON definisi tindakan untuk mendeklarasikan input dan output tindakan aplikasi. Sekumpulan API WinRT yang mewakili entitas juga tersedia untuk bekerja dengan entitas dalam kode. Untuk informasi selengkapnya, lihat Namespace Windows.AI.Actions.

Catatan AI Bertanggung Jawab

Saat membangun Tindakan yang didukung AI, Anda bertanggung jawab sebagai pengembang Tindakan untuk melakukan moderasi konten dan pemantauan penyalahgunaan terkait dengan entitas yang dikembalikan kepada pengguna. Untuk informasi selengkapnya tentang kebijakan Microsoft Responsible AI untuk informasi selengkapnya, lihat Microsoft Responsible AI: Prinsip dan pendekatan

Nota

Pertimbangkan apakah anak-anak harus memiliki akses ke tindakan menggunakan properti 'contentAgeRating' dalam definisi tindakan JSON.

Tindakan Aplikasi dimaksudkan untuk menyediakan unit fungsionalitas atomik yang berlaku untuk skenario dan alur kerja di luar aplikasi penyedia. Misalnya, tindakan mungkin menerjemahkan sepotong teks, atau memproses gambar. Untuk skenario yang sepenuhnya spesifik untuk aplikasi Windows yang mengimplementasikan perilaku, jalur yang direkomendasikan adalah menerapkan titik ekstensibilitas kustom dengan ekstensi aplikasi. Untuk informasi selengkapnya, lihat Membuat dan menghosting ekstensi aplikasi.

Daftar berikut menjelaskan beberapa jenis fungsionalitas yang berpotensi menjadi kandidat bagus untuk diterapkan sebagai aksi.

  • Fungsionalitas secara luas berlaku dan dapat digunakan kembali. Fungsionalitas ini ditujukan untuk penemuan dan penggunaan kembali di beberapa aplikasi atau konteks (misalnya, operasi file, pencetakan).
  • Aplikasi lain dapat menyusun dan memperluas fungsionalitas.
  • Fungsionalitas tergantung konteks dan harus ditemukan secara dinamis pada runtime (misalnya, menampilkan perintah khusus konteks dalam UI).
  • Fungsionalitas terintegrasi dengan alat sistem yang ada atau ekosistem aplikasi lainnya.
  • Fungsionalitas menyederhanakan interaksi pengguna dengan merangkum tugas kompleks ke dalam satu tindakan tingkat yang lebih tinggi (misalnya, otomatisasi berbasis pengguna).
  • Fungsionalitas dapat beroperasi secara independen dari kontrol internal aplikasi dan tidak perlu mengikuti protokol khusus aplikasi yang ketat.
  • Fungsionalitas yang diharapkan dapat ditemukan dan dipanggil dengan cara yang seragam di berbagai bagian sistem atau aplikasi lain (misalnya, API untuk memanipulasi file atau berbagi konten).