首頁(yè) > 文檔中心 > 實(shí)時(shí)數(shù)據(jù)傳輸 > P2P與數(shù)據(jù)傳輸 > 影像傳輸

[分區(qū)]通用的P2P分區(qū)設(shè)定

P2P分區(qū)設(shè)定策略 | TUTK P2P SDK 開(kāi)發(fā)指南

一、概述

TUTK P2P SDK從3.1.10版本開(kāi)始，新增了區(qū)域設(shè)定的API，用以限制APP或者設(shè)備只訪問(wèn)指定區(qū)域的服務(wù)器，實(shí)現(xiàn)區(qū)域化管理和合規(guī)要求（如GDPR）。

1. 支持的分區(qū)類(lèi)型

目前TUTK官方支持的區(qū)域劃分：

中國(guó)區(qū)：CN
北美區(qū)：US
歐洲區(qū)：EU
亞洲區(qū)：ASIA（不含中國(guó)區(qū)）

2. 架構(gòu)對(duì)比

圖1：默認(rèn)全區(qū)架構(gòu)示意圖（APP/設(shè)備可訪問(wèn)所有區(qū)域服務(wù)器）

全區(qū)架構(gòu)下，APP或設(shè)備將自動(dòng)匹配并訪問(wèn)所有區(qū)域的服務(wù)器，適用于無(wú)區(qū)域限制的全球化部署場(chǎng)景。

圖2：分區(qū)架構(gòu)示意圖（APP/設(shè)備僅訪問(wèn)指定區(qū)域服務(wù)器）

分區(qū)架構(gòu)下，APP或設(shè)備通過(guò)API指定區(qū)域后，僅會(huì)訪問(wèn)該區(qū)域的P2P服務(wù)器和對(duì)應(yīng)Master服務(wù)器，實(shí)現(xiàn)區(qū)域隔離。

合規(guī)說(shuō)明

若需符合GDPR（通用數(shù)據(jù)保護(hù)條例）要求，需將P2P服務(wù)器、APP端、設(shè)備端的區(qū)域統(tǒng)一設(shè)定為歐洲區(qū)（EU），確保數(shù)據(jù)僅在歐洲區(qū)域內(nèi)傳輸和存儲(chǔ)。

二、P2P服務(wù)器的分區(qū)設(shè)定

通過(guò)配置P2P服務(wù)器啟動(dòng)腳本中的 P2P_SERVICE_REGION 字段，指定服務(wù)器提供服務(wù)的目標(biāo)區(qū)域。

啟動(dòng)腳本配置（bash）：

#!/bin/bash export P2P_LICENSE_KEY= #填寫(xiě)申請(qǐng)好的P2P License Key export P2P_SERVER_KEY= #填寫(xiě)申請(qǐng)好的Server Key export P2P_SERVICE_REGION=all #設(shè)定需要服務(wù)的區(qū)域，可選值：'asia', 'us', 'eu', 'cn' 或 'all' export P2P_LOCAL_REGION=non-cn #P2P服務(wù)器物理區(qū)域，可選值：'cn'（中國(guó)區(qū)）或 'non-cn'（非中國(guó)區(qū)） CUR_DIR=$(cd `dirname $0`; pwd) #獲取程序運(yùn)行目錄（用于開(kāi)機(jī)重啟路徑配置） s=1 while [ "$s" != "0" ] do if [ $(ps -A | grep -c 'IOTC_Server') == "0" ]; then ${CUR_DIR}/IOTC_Server --config=${CUR_DIR}/config.db -gP:G -p10001 & fi sleep 5 done

配置說(shuō)明：

P2P_SERVICE_REGION：指定服務(wù)器服務(wù)的區(qū)域，例如歐洲區(qū)服務(wù)器填寫(xiě) eu，需與APP/設(shè)備端設(shè)定的區(qū)域一致；
P2P_LOCAL_REGION：服務(wù)器物理部署區(qū)域，僅區(qū)分 cn 和 non-cn，用于網(wǎng)絡(luò)優(yōu)化；
-gP:G：替換為實(shí)際的VPG標(biāo)識(shí)（VID:PID:GID組合），綁定目標(biāo)設(shè)備群組。

三、APP和設(shè)備端的區(qū)域設(shè)定

APP和設(shè)備端通過(guò)SDK提供的專(zhuān)用API設(shè)定區(qū)域，需根據(jù)SDK版本選擇對(duì)應(yīng)接口，且區(qū)域設(shè)定必須在SDK初始化前完成。

（一）API定義

1. SDK 4.3.3以下版本（APP端+設(shè)備端通用）

#include "TUTKGlobalAPIs.h" /** * @brief 設(shè)定區(qū)域編碼（全局生效） * @param region 區(qū)域字符串（SDK預(yù)定義常量） * @return 0：成功，非0：失敗 */ TUTK_GLOBAL_APIs int32_t TUTK_SDK_Set_Region_Code(const char * region);

2. SDK 4.5.0以上版本（區(qū)分APP端和設(shè)備端）

// 設(shè)備端API（與低版本兼容） #include "TUTKGlobalAPIs.h" TUTK_GLOBAL_APIs int32_t TUTK_SDK_Set_Region_Code(const char * region); // APP端API（支持單設(shè)備精準(zhǔn)設(shè)定） #include "IOTCAPIs.h" /** * @brief 帶區(qū)域設(shè)定的P2P連線接口 * @param cszUID 目標(biāo)設(shè)備UID * @param SID 會(huì)話ID（通過(guò)IOTC_Get_SessionID()獲取） * @param connectInput 連線參數(shù)（含區(qū)域信息） * @return 0：成功，非0：失敗 */ int32_t IOTC_Connect_ByUIDEx(const char * cszUID, int32_t SID, IOTCConnectInput* connectInput);

區(qū)域常量說(shuō)明：

SDK預(yù)定義區(qū)域字符串常量，直接調(diào)用無(wú)需手動(dòng)輸入：

REGION_STRING_CN："cn" //中國(guó)區(qū)
REGION_STRING_US："us" //北美區(qū)
REGION_STRING_EU："eu" //歐洲區(qū)
REGION_STRING_ASIA："asia" //亞洲區(qū)（不含中國(guó)）

（二）代碼示例

1. 設(shè)備端示例（所有SDK版本通用）：

// 步驟1：設(shè)定區(qū)域（必須在IOTC_Initialize2之前調(diào)用） TUTK_SDK_Set_Region_Code(REGION_STRING_EU); // 設(shè)定為歐洲區(qū) // 步驟2：初始化SDK IOTC_Initialize2(SDK_LICENSE_KEY); // 后續(xù)執(zhí)行設(shè)備相關(guān)邏輯