upnphostingdevice.java

国外的j2me播放器软件

package no.auc.one.portableplayer.communication.upnphosting;

import java.util.Hashtable;
import javax.microedition.lcdui.Image;

/**
 * Specifies all required information for a UPnP device to be hosted.
 *
 * Currently does not support presentation (e.g. a website for controlling 
 * the device) and embedded devices.
 */
public interface UPnPHostingDevice {

    /**
     * Major version of the UPnP Device Architecture supported.
     *
     * @return Major version
     */
    byte specVersionMajor();

    /**
     * Minor version of the UPnP Device Architecture supported.
     *
     * @return Minor version
     */
    byte specVersionMinor();

    /**
     * UPnP Device Type
     *
     * For standard devices defined by a UPnP Forum working committee, must 
     * begin with urn:schemas-upnp-org:device: followed by a device type 
     * suffix, colon, and an integer device version.
     * 
     * For non-standard devices specified by UPnP vendors, must begin with 
     * urn:, followed by an ICANN domain name owned by the vendor, followed 
     * by :device:, followed by a device type suffix, colon, and an integer 
     * version, i.e., urn:domain-name:device:deviceType:v.
     */
    String deviceType();

    /**
     * Short description for end user.
     *
     * Should be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). Specified 
     * by UPnP vendor. String. Should be < 64 characters.
     */
    String friendlyName();

    /**
     * Manufacturer's name.
     *
     * May be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). Specified by 
     * UPnP vendor. String. Should be < 64 characters.
     */
    String manufacturer();

    /**
     * Web site for Manufacturer.
     *
     * May be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). May be 
     * relative to base URL. Specified by UPnP vendor. Single URL.
     */
    String manufacturerUrl();
    
    /**
     * Long description for end user.
     *
     * Should be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). Specified 
     * by UPnP vendor. String. Should be < 128 characters.
     */
    String modelDescription();

    /**
     * Model name.
     *
     * May be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). Specified by 
     * UPnP vendor. String. Should be < 32 characters.
     */
    String modelName();

    /**
     * Model number.
     *
     * May be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). Specified by 
     * UPnP vendor. String. Should be < 32 characters.
     */
    String modelNumber();
    
    /**
     * Web site for model.
     *
     * May be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). May be 
     * relative to base URL. Specified by UPnP vendor. Single URL.
     */
    String modelUrl();

    /**
     * Serial number.
     *
     * May be localized (cf. ACCEPT-/CONTENT-LANGUAGE headers). Specified by 
     * UPnP vendor. String. Should be < 64 characters.
     */
    String serialNumber();

    /**
     * Unique Device Name.
     *
     * Universally-unique identifier for the device, whether root or 
     * embedded. Must be the same over time for a specific device instance 
     * (i.e., must survive reboots). Must match the value of the NT header in 
     * device discovery messages. Must match the prefix of the USN header in 
     * all discovery messages. (The section on Discovery explains the NT and 
     * USN headers.) Must begin with uuid: followed by a UUID suffix 
     * specified by a UPnP vendor. Single URI.
     */
    String udn();

    /**
     * Universal Product Code.
     *
     * 12-digit, all-numeric code that identifies the consumer package. 
     * Managed by the Uniform Code Council. Specified by UPnP vendor. Single 
     * UPC. 
     */
    String upc();

    /**
     * Icon to depict device in a control point UI.
     *
     * Specified by UPnP vendor.  May be localized (cf. ACCEPT-/CONTENT-
     * LANGUAGE headers).
     * List should include one icon in each of the following sizes: 
     * (width x height x depth): 16x16x1, 16x16x8, 32x32x1, 32x32x8, 48x48x1, 
     * 48x48x8.
     *
     * @return List of icons. If no icons are defined then it must return 
     * null.
     */
    Image[] iconList();

    /**
     * List of services supported by this device.
     *
     * @return Hashtable with ServiceIds as keys and UPnPHostingService as 
     *         values.
     */
    Hashtable serviceTable();
}