/// <summary> /// Creates the UPnP description document for this root device and all embedded devices. /// </summary> /// <param name="serverData">Current server data structure.</param> /// <param name="config">UPnP endpoint which will be used to create the endpoint specific information. The comment of /// <see cref="DeviceTreeURLGenerator"/> describes why URLs must be adapted for each UPnP endpoint.</param> /// <param name="culture">The culture to localize strings and URLs of the returned description document.</param> /// <returns>UPnP device description document for this root device and all embedded devices.</returns> public string BuildRootDeviceDescription(ServerData serverData, EndpointConfiguration config, CultureInfo culture) { StringBuilder result = new StringBuilder(10000); using (StringWriterWithEncoding stringWriter = new StringWriterWithEncoding(result, UPnPConsts.UTF8_NO_BOM)) using (XmlWriter writer = XmlWriter.Create(stringWriter, UPnPConfiguration.DEFAULT_XML_WRITER_SETTINGS)) { GenerateDescriptionDlgt dgh = DescriptionGenerateHook; writer.WriteStartDocument(); writer.WriteStartElement(string.Empty, "root", UPnPConsts.NS_DEVICE_DESCRIPTION); if (dgh != null) { dgh(writer, this, GenerationPosition.RootDeviceStart, config, culture); } writer.WriteAttributeString("configId", config.ConfigId.ToString()); writer.WriteStartElement("specVersion"); writer.WriteElementString("major", UPnPConsts.UPNP_VERSION_MAJOR.ToString()); writer.WriteElementString("minor", UPnPConsts.UPNP_VERSION_MINOR.ToString()); writer.WriteEndElement(); // specVersion AddDeviceDescriptionsRecursive(writer, config, culture); if (dgh != null) { dgh(writer, this, GenerationPosition.RootDeviceEnd, config, culture); } writer.WriteEndElement(); // root writer.Close(); } return(result.ToString()); }
/// <summary> /// Creates the UPnP device description XML fragment for this device, all embedded devices and all services. /// </summary> /// <param name="writer">Result XML writer to add the device descriptions fragment to.</param> /// <param name="config">UPnP endpoint which will be used to create the endpoint specific information.</param> /// <param name="culture">Culture to create the culture specific information.</param> internal void AddDeviceDescriptionsRecursive(XmlWriter writer, EndpointConfiguration config, CultureInfo culture) { GenerateDescriptionDlgt dgh = DescriptionGenerateHook; ILocalizedDeviceInformation deviceInformation = _deviceInformation; writer.WriteStartElement("device"); if (dgh != null) { dgh(writer, this, GenerationPosition.DeviceStart, config, culture); } writer.WriteElementString("deviceType", DeviceTypeVersion_URN); writer.WriteElementString("friendlyName", deviceInformation.GetFriendlyName(culture)); writer.WriteElementString("manufacturer", deviceInformation.GetManufacturer(culture)); string manufacturerURL = deviceInformation.GetManufacturerURL(culture); if (!string.IsNullOrEmpty(manufacturerURL)) { writer.WriteElementString("manufacturerURL", manufacturerURL); } string modelDescription = deviceInformation.GetModelDescription(culture); if (!string.IsNullOrEmpty(modelDescription)) { writer.WriteElementString("modelDescription", modelDescription); } writer.WriteElementString("modelName", deviceInformation.GetModelName(culture)); string modelNumber = deviceInformation.GetModelNumber(culture); if (!string.IsNullOrEmpty(modelNumber)) { writer.WriteElementString("modelNumber", modelNumber); } string modelURL = deviceInformation.GetModelURL(culture); if (!string.IsNullOrEmpty(modelURL)) { writer.WriteElementString("modelURL", modelURL); } string serialNumber = deviceInformation.GetSerialNumber(culture); if (!string.IsNullOrEmpty(serialNumber)) { writer.WriteElementString("serialNumber", serialNumber); } writer.WriteElementString("UDN", UDN); string upc = deviceInformation.GetUPC(); if (!string.IsNullOrEmpty(upc)) { writer.WriteElementString("UPC", upc); } ICollection <IconDescriptor> icons = deviceInformation.GetIcons(culture); if (icons != null && icons.Count > 0) { writer.WriteStartElement("iconList"); foreach (IconDescriptor icon in icons) { writer.WriteStartElement("icon"); writer.WriteElementString("mimetype", icon.MimeType); writer.WriteElementString("width", icon.Width.ToString()); writer.WriteElementString("height", icon.Height.ToString()); writer.WriteElementString("depth", icon.ColorDepth.ToString()); writer.WriteElementString("url", icon.GetIconURLDelegate(config.EndPointIPAddress, culture)); writer.WriteEndElement(); // icon } writer.WriteEndElement(); // iconList } ICollection <DvService> services = _services; if (services.Count > 0) { writer.WriteStartElement("serviceList"); foreach (DvService service in services) { service.AddDeviceDescriptionForService(writer, config); } writer.WriteEndElement(); // serviceList } ICollection <DvDevice> embeddedDevices = _embeddedDevices; if (embeddedDevices.Count > 0) { writer.WriteStartElement("deviceList"); foreach (DvDevice embeddedDevice in embeddedDevices) { embeddedDevice.AddDeviceDescriptionsRecursive(writer, config, culture); } writer.WriteEndElement(); // deviceList } if (dgh != null) { dgh(writer, this, GenerationPosition.AfterDeviceList, config, culture); } GetURLForEndpointDlgt presentationURLGetter = GetPresentationURLDelegate; string presentationURL = null; if (presentationURLGetter != null) { presentationURL = presentationURLGetter(config.EndPointIPAddress, culture); } if (!string.IsNullOrEmpty(presentationURL)) { writer.WriteElementString("presentationURL", presentationURL); } if (dgh != null) { dgh(writer, this, GenerationPosition.DeviceEnd, config, culture); } writer.WriteEndElement(); // device }