Tentang Layanan Web di Perangkat

Web Service on Devices API (WSDAPI) adalah implementasi dari Profil Perangkat untuk Layanan Web (DPWS) untuk Windows Vista dan Windows Server 2008. DPWS membatasi spesifikasi Layanan Web sehingga klien dapat dengan mudah menemukan perangkat. Setelah perangkat ditemukan, klien dapat mengambil deskripsi layanan yang dihosting di perangkat tersebut dan menggunakan layanan tersebut.

Perangkat dan Layanan

Perangkat adalah komponen, biasanya perangkat keras, yang terpasang pada jaringan. Contohnya termasuk printer, kamera Web, dan sistem video.

Perangkat dapat mencakup nol atau lebih layanan. Misalnya, perangkat video dapat mencakup layanan yang mendukung daya hidup dan mati, kontrol pemutaran, ejeksi media, dan streaming video. Kontrol putar dapat mendukung tindakan seperti putar, jeda, gulung balik, dan maju cepat.

Menemukan dan Memanipulasi Perangkat

WSDAPI memperluas model Plug and Play lokal dengan memungkinkan klien menemukan dan mengakses perangkat jarak jauh dan layanan terkait di seluruh jaringan. Ini mendukung penemuan, pesan kontrol satu arah dan dua arah, dan peristiwa.

Perangkat DPWS mengumumkan kehadiran dan mengekspos layanan mereka (jika ada) menggunakan alamat unik dan sekumpulan pesan XML standar. Klien DPWS dapat menggunakan proses penemuan untuk menemukan perangkat, menghitung layanannya, dan terhubung ke layanan tersebut untuk melakukan tindakan tertentu.

Klien WSDAPI pertama kali meminta perangkat untuk deskripsi lengkap tentang layanannya, termasuk jenis layanan (seperti jenis layanan printer atau jenis layanan pemindai). Klien kemudian mengontrol perangkat dengan memanggil perintah yang ditentukan oleh jenis layanan (misalnya, dengan memanggil CreatePrintJob pada perangkat dengan jenis layanan printer). Secara opsional, klien juga dapat memantau perubahan status di setiap layanan dengan berlangganan peristiwa yang terjadi selama eksekusi perintah.

Untuk informasi selengkapnya tentang pola olahpesan perangkat, lihat Penemuan dan Pola Pesan Pertukaran Metadata.

Alamat Logis dan Fisik

Alamat logis digunakan untuk mengidentifikasi perangkat secara unik terlepas dari alamat fisiknya. WS-Discovery menyediakan mekanisme untuk menyelesaikan alamat logis ke alamat fisik, memungkinkan olahpesan klien-ke-perangkat berlangsung. Contohnya adalah penyimpanan terpasang jaringan (NAS) yang Anda bawa bersama Anda. Jika Anda memiliki laptop dan NAS, laptop Anda harus dapat mengenali bahwa itu adalah perangkat yang sama, terlepas dari alamat fisik (alamat IP) yang diperoleh NAS saat Anda berpindah antar subnet. Mencapai hal ini mengharuskan perangkat memiliki identitas yang independen dari alamat IP yang diperolehnya; karena mekanisme tradisional seperti DNS tidak tersedia dalam skenario roaming normal, WS-Addressing dan WS-Discovery memberikan alamat dan resolusi logis sebagai alternatif ad-hoc.

Ketika perangkat diproduksi, perangkat diberi pengidentifikasi unik global, yang direpresentasikan sebagai URI UUID. Pengidentifikasi ini tidak akan pernah berubah untuk perangkat. Ketika perangkat dinyalakan, perangkat akan selalu mengumumkan alamat logisnya melalui pesan WS-Discovery Hello , dan akan menerima permintaan untuk mengonversinya ke alamat fisik (biasanya HTTP) melalui pesan Penyelesaian atau Pemeriksaan WS-Discovery. Setelah alamat fisik (alamat IP) yang valid diperoleh, semua pesan terjadi melalui alamat tersebut, dan WS-Discovery digunakan hanya jika alamat berubah, status perubahan perangkat dan klien perlu diberi tahu, atau perangkat offline.

Membangun Aplikasi

WSDAPI menyediakan tumpukan SOAP DPWS generik untuk digunakan oleh aplikasi klien dan layanan. Web Services on Devices Code Generator (WsdCodeGen.exe) dapat digunakan untuk mengonversi deskripsi layanan (WSDL) menjadi kode proksi dan stub yang dapat dipanggil aplikasi secara langsung. Kode yang dihasilkan ini secara otomatis mengubah panggilan fungsi dan parameter menjadi pesan SOAP dan bidang XML, lalu memanggil ke WSDAPI untuk mengeluarkan permintaan ke perangkat jarak jauh atau klien.

Penemuan Fungsi dapat digunakan saat membangun aplikasi WSDAPI untuk membuat dan mengaktifkan instans fungsi yang dikembalikan oleh PnP. Instans fungsi ini berisi data yang dapat digunakan untuk mendapatkan informasi lebih lanjut melalui API PnP ketika diperlukan lebih dari sekadar penemuan sederhana. Untuk informasi selengkapnya, lihat Penemuan Fungsi dan PnP-X.

Topik terkait

Penemuan dan Pola Pesan Pertukaran Metadata

Kepatuhan Spesifikasi WSDAPI

Gambaran Umum Antarmuka WSDAPI