MiniUPnP：简洁易用的 UPnP 客户端和服务器开发库

UPnP（通用即插即用协议）是一种网络协议，旨在使设备之间的通信更加自动化和易于使用。它允许设备自动检测其他设备，确定它们支持哪些功能，并在不需要用户干预的情况下使它们相互通信。

MiniUPnP是一种UPnP客户端和服务器开发库，可以在C语言中轻松实现UPnP功能。 MiniUPnP是一个可移植的库，可在各种操作系统和平台上开发。这个库提供了一组API，可以编写客户端应用程序，以便与UPnP兼容设备交互，也可以编写服务器应用程序来向网络中的其他设备提供服务。

一、MiniUPnP的基础架构

MiniUPnP的基础架构由两个部分组成：客户端和服务器。客户端需要通过UPnP协议连接到其他设备，并请求它们提供服务或获取信息。服务器通常在某个设备上运行，并使本地资源可用于其他设备。

MiniUPnP客户端提供了一组API，可以实现UPnP设备的发现和描述。客户端应用程序可以使用这些API查找设备并检索它们的信息。客户端还可以订阅UPnP设备上的事件，以便实时获取设备状态的变化。

MiniUPnP服务器提供了一组API，可用于使本地资源（例如音频，视频或文件）可用于其他设备。服务器可以在本地设备上注册本地资源，并通过UPnP协议将它们公开为UPnP服务。其他设备可以使用这些服务来访问本地资源，进而与服务器交互。

二、MiniUPnP的主要功能

MiniUPnP具有以下主要功能：

1. 发现UPnP设备

MiniUPnP客户端提供了一组API，可以实现UPnP设备的检测和发现。客户端应用程序可以使用这些API搜索本地网络中的设备，以便查找UPnP服务。

2. 描述UPnP设备

MiniUPnP客户端提供了一组API，可以获取设备的信息，例如设备名称，制造商，模型号和设备支持的服务列表。客户端应用程序可以使用这些信息识别设备，并确保其支持所需的服务。

3. 订阅UPnP设备事件

MiniUPnP客户端提供了一组API，可用于订阅UPnP设备上的事件，例如设备状态更改，服务状态更改等。客户端应用程序可以使用这些API将自己注册为UPnP设备上事件的接收者，并在事件发生时执行相应的操作。

4. 提供UPnP服务

MiniUPnP服务器提供了一组API，可以将本地资源公开为UPnP服务。服务器可以注册本地资源，并在UPnP设备上公开它们，以便其他设备可以使用UPnP协议访问它们。

5. 控制UPnP设备

MiniUPnP客户端提供了一组API，可以控制UPnP设备上的服务。客户端应用程序可以在UPnP设备上执行操作，如启动服务，停止服务等。

三、MiniUPnP的代码示例

以下是一些使用MiniUPnP库的示例代码：

// 初始化MiniUPnP客户端
struct UPNPDev * devlist = 0;
devlist = upnpDiscover(2000, multicastif, minissdpdsock, 0);
if(devlist)
{
    // 遍历设备描述
    struct UPNPDev * device;
    for(device = devlist; device; device = device->pNext)
    {
        char * descXML = 0;
        int descXMLsize = 0;

        // 获取设备描述XML
        descXMLsize = httpDownload(device->descURL, &descXML, 0, NULL);
        if(descXMLsize > 0)
        {
            // 分析设备发现
            struct UPnPDevice * rootDevice;
            rootDevice = UPNP_GetDeviceFromXML(descXML, descXMLsize);
            if(rootDevice)
            {
                // 遍历设备服务
                struct UPnPService * service;
                for(service = rootDevice->pServiceList; service; service = service->pNext)
                {
                    printf("service: %s\n", service->serviceType);
                }
                UPNP_FreeDevice(rootDevice);
            }
            free(descXML);
        }
    }
    freeUPNPDevlist(devlist);
}

上述示例代码演示了如何使用MiniUPnP客户端API查找UPnP设备并分析其描述XML。该代码遍历每个设备，获取描述XML并从中提取服务列表。

以下是使用MiniUPnP服务器API公开本地资源的示例代码：

// 初始化MiniUPnP服务器
struct UPNPUrls urls;
struct IGDdatas data;
char * multicastif = 0;
int r = UPNP_GetValidIGD(multicastif, &urls, &data, lanaddr, sizeof(lanaddr));
if(r == 1)
{
    // 注册本地资源
    int port = 8080;
    char * descXML = UPNP_CreateIGD(1, port, port, "", 0);
    int expiration = 3600;
    char * registerURL = 0;
    int result = UPNP_AddPortMapping(urls.controlURL, data.first.servicetype,
        "http", "http", "", 0, port, lanaddr, descXML, expiration, registerURL);
    if(result == UPNPCOMMAND_SUCCESS)
    {
        printf("Port mapping successful\n");
        if(registerURL)
        {
            free(registerURL);
        }
    }
    else
    {
        printf("Port mapping failed\n");
    }
    free(descXML);
}

该示例代码演示了如何使用MiniUPnP服务器API在UPnP设备上注册本地资源。该代码定义了要注册的资源的端口号和描述XML，并在UPnP设备上创建新的端口映射以公开该资源。

四、结语

MiniUPnP是一个非常优秀的UPnP客户端和服务器开发库，它的API简单易用，可以在C语言中轻松实现UPnP功能。该库具有广泛的可移植性，可以在各种平台上开发，适用于各种应用场景，如网络设备管理、P2P文件共享等。

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/220092.html