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/zh-tw/n/220092.html