Compartir vía

Simulated Webcam

  • Artículo

Glossary Item Box

Microsoft Robotics Developer Studio Send feedback on this topic

Simulated Webcam

The SimulatedWebcam service demonstrates how to simulate a webcam using the simulation engine's CameraEntity.

This sample is provided in the C# language. You can find the project files for this sample at the following location under the Microsoft Robotics Developer Studio installation folder:

Samples\Simulation\Sensors\SimulatedWebcam

Contents:

  • Setting Up the Service
  • Running the Service
  • Using the Service

Prerequisites

Hardware

This service requires no special hardware apart from a suitable graphics card to run the Simulator.

Software

This software is designed to run with Microsoft Robotics Developer Studio.

Setting Up the Service

The SimulatedWebcam service is installed automatically with RDS. The sample that shows usage of the SimulatedWebcam service is the simulation tutorial Simple Robot with Drive.

The simulated webcam implements the Generic Web Camera service contract so that it can be used by other services.

Running the Service

There are two different methods to start the SimulatedWebcam service. Either:

  • Start the service by adding the service to a manifest either through DSS Manifest Editor (DSSME) or manually with any text editor. The below XML shows how the SimulatedWebcam service should appear in the manifest.

    <?xml version="1.0"?>
<Manifest 
    xmlns:simulation="https://schemas.microsoft.com/robotics/2006/04/simulation.html" 
    xmlns:simulatedwebcam="https://schemas.microsoft.com/2006/09/simulatedwebcam.html" 
    xmlns:this="urn:uuid:9adb2c6b-48c8-45ac-a0f7-3f4cc2d4ebd0" 
    xmlns:dssp="https://schemas.microsoft.com/xw/2004/10/dssp.html" 
    xmlns="https://schemas.microsoft.com/xw/2004/10/manifest.html">
  <CreateServiceList>
    <!--Any other services you want to start could be here-->
    <ServiceRecordType>
      <dssp:Contract>https://schemas.microsoft.com/2006/09/simulatedwebcam.html</dssp:Contract>
      <dssp:PartnerList>
        <dssp:Partner>
          <dssp:Service>https://localhost/CameraEntityName</dssp:Service>
          <dssp:PartnerList />
          <dssp:Name>simulation:Entity</dssp:Name>
        </dssp:Partner>
      </dssp:PartnerList>
      <Name>this:SimulatedWebcam</Name>
    </ServiceRecordType>
  </CreateServiceList>
</Manifest>

  • Start the service programatically in code that generates a simulation environment:

    Microsoft.Robotics.Services.Simulation.Sensors.SimulatedWebcam.Proxy.Contract.CreateService(
  ConstructorPort, "https://localhost/" + cameraEntity.State.Name,
  Microsoft.Robotics.Simulation.Partners.CreateEntityPartner(
      "https://localhost/" + cameraEntity.State.Name)
);

Using the Service

To retrieve an up to date copy of the webcam's image, post a QueryFrameRequest and receive a QueryFrameResponse. You can do this either programatically or through VPL.

Summary

This sample covered the following:

  • Setting Up the Service
  • Running the Service
  • Using the Service

 

 

© 2012 Microsoft Corporation. All Rights Reserved.