UPnP库使用指南：MiniUPnP和libupnp实战解析

UPnP库使用指南：MiniUPnP和libupnp实战解析

UPnP（通用即插即用协议）是一种网络协议，旨在简化网络设备之间的发现和交互。UPnP库允许开发者使用UPnP协议创建与UPnP兼容设备进行通信的应用程序。本文将介绍两个常用的UPnP库：MiniUPnP和libupnp，并提供它们的详细使用方法。

1. MiniUPnP

MiniUPnP是一个轻量级的UPnP实现，可以在任何平台上编译和运行。以下是使用MiniUPnP库的基本步骤：

#include <miniupnpc/miniupnpc.h> // 包含MiniUPnP库的头文件
#include <miniupnpc/upnpcommands.h>

int main()
{
  struct UPNPDev * devlist = 0;
  struct UPNPUrls urls;
  struct IGDdatas data;
  const char * multicastif = 0;
  const char * minissdpdpath = 0;
  int error = 0;

  // 发现UPnP设备并获取设备列表
  devlist = upnpDiscover(2000, multicastif, minissdpdpath, 0, 0, &error);

  // 获取第一个设备的URL和数据
  error = UPNP_GetValidIGD(devlist, &urls, &data, lanaddr, sizeof(lanaddr));

  // 添加端口映射
  UPNP_AddPortMapping(urls.controlURL, data.first.servicetype, 'external_port', 'internal_port', 'internal_client', 'description', 'lease_duration');

  // 删除端口映射
  UPNP_DeletePortMapping(urls.controlURL, data.first.servicetype, 'external_port', 'protocol');

  // 释放资源
  freeUPNPDevlist(devlist);
  return 0;
}

2. libupnp

libupnp是一个功能更加强大的UPnP实现，支持更多类型的UPnP设备。以下是使用libupnp库的基本步骤：

#include <upnp/upnp.h> // 包含libupnp库的头文件

int main()
{
  UpnpDevice_Handle device_handle;
  UpnpDevice_Handle device_handle2;
  char * desc_doc = NULL;
  int desc_doc_size = 0;
  int err_code = 0;

  // 初始化UPnP库
  UpnpInit(NULL, 0);

  // 创建UPnP设备
  UpnpRegisterRootDevice('description.xml', handle_root_device_request, &device_handle, &err_code);

  // 发送事件通知
  UpnpSendEvent(device_handle, 'urn:schemas-upnp-org:service:serviceType:1', 'EventName', '', 0);

  // 获取设备描述文档
  UpnpDownloadUrlItem('http://192.168.1.1:49152/rootDesc.xml', &desc_doc, &desc_doc_size, NULL);

  // 解析设备描述文档
  UpnpDeviceDesc * device_desc = UpnpGetDeviceDescription(desc_doc, desc_doc_size);

  // 获取服务列表
  UpnpService * service_list;
  int num_services;
  UpnpGetServices(device_desc, &service_list, &num_services);

  // 释放资源
  free(desc_doc);
  UpnpFreeDeviceDescription(device_desc);
  UpnpFinish();
  return 0;
}

总结

MiniUPnP和libupnp都是常用的UPnP库，它们提供了不同的功能和使用方法。开发者可以根据自己的需求选择合适的库来实现UPnP协议的应用程序。在使用这些库时，开发者应该参考官方文档，了解每个函数的作用和参数，并注意资源的释放，避免内存泄漏和其他问题。