Unity接入阿里云公共DNS SDK最佳方案

1. 导入Plugins文件。

将PdnsUnityDemo中 Plugins 文件夹中的文件复制到您 Unity 工程>Assets>Plugins 文件夹中。

2. 配置参数。

AlipdnsHelper.setAccountId("accountId");
AlipdnsHelper.setAccessKeyId("accessKeyId");
AlipdnsHelper.setAccesskeySecret("accesskeySecret");
AlipdnsHelper.setCacheEnable(true);
AlipdnsHelper.setSchedulePrefetchEnable(true);
AlipdnsHelper.setIspEnable(true);
AlipdnsHelper.setMaxCacheTTL(3600);
AlipdnsHelper.setMaxNegativeCache(60);
AlipdnsHelper.setScheme(1);
AlipdnsHelper.setShortEnable(false);
AlipdnsHelper.setSpeedTestEnable(true);
AlipdnsHelper.setCacheCountLimit(100);
AlipdnsHelper.setSpeedPort(80);
// 预解析域名
List<string> list = new List<string>();
list.Add("域名1");
list.Add("域名2");
AlipdnsHelper.setPreloadDomains(list);

接口类为AlipdnsHelper.cs。

1. 必传参数，您在控制台注册后，控制台会生成唯一标识Account ID。

public static void setAccountId(string accountId)

2. 必传参数，在控制台开启鉴权后生成该参数，设置鉴权功能来保障用户身份安全，不被第三方未授权者盗用。

public static void setAccessKeyId(string accessKeyId)
public static void setAccesskeySecret(string accesskeySecret)

3. 设置开启缓存，在第一次解析过域名后，后续再解析时， 优先获取缓存中的数据，可大大提高解析速度。

public static void setCacheEnable(bool enable)

4. 设置是否开启定时主动更新过期缓存，开启后SDK每分钟会自动更新过期缓存，保障用户缓存数据及时更新，但是可能会带来域名解析次数和客户端流量消耗的增多。

public static void setSchedulePrefetchEnable(bool enable)

5. 设置是否开启依据ISP网络区分域名缓存，开启后则在不同网络环境下域名缓存数据分别存储互不影响。如果不开启，则不同网络下使用同一份域名缓存数据。

public static void setIspEnable(bool enable)

6. 设置缓存最大TTL时间，如果设置了该时间，则会限制缓存的最大TTL不超过该设置时间。

   SDK默认该参数为3600s。

public static void setMaxCacheTTL(double maxCacheTTL)

7. 设置否定缓存最大TTL时间，设置了该时间，则会限制否定缓存的最大TTL不超过该设置时间。

   SDK默认该参数为30s。

public static void setMaxNegativeCache(double maxNegativeCache)

8. 在访问DNS服务器进行解析时，是通过HTTP协议解析，还是通过HTTPS协议解析，可通过scheme属性进行设置。scheme默认是0，使用HTTP协议进行解析，建议使用HTTP协议进行解析，解析速度更快，scheme设为1即使用HTTPS协议进行解析。

public static void setScheme(int scheme)

9. 设置是否开启short模式，阿里公共DNS的DoH JSON API返回数据分为全量JSON和简要IP数组格式。SDK默认为全量JSON格式。

public static void setShortEnable(bool enable)

10. 设置是否开启IP优选，开启后解析结果数组会按照测速结果由快到慢的顺序排列。

public static void setSpeedTestEnable(bool enable)

11. 设置缓存数量，可以自定义缓存数量（支持范围100～500之间）。

public static void setCacheCountLimit(int cacheCountLimit)

12. 设置IP测速优选端口，设置socket探测指定端口。

public static void setSpeedPort(int speedPort)

13. 由于SDK自带缓存功能，在第一次解析完域名后，后续再次解析此域名可大大提高解析速度，所以建议在app启动后，可对app中可能要解析的域名进行预加载。

public static void setPreloadDomains(List<string> hosts)

14. 自动感知网络环境（ipv4-only、ipv6-only、ipv4和ipv6双栈）直接从缓存中获取适用于当前网络环境的IP数组，无需等待。如无缓存，或有缓存但已过期并且expiredIPEnabled为false，则返回空。

@param host 域名

@expiredIPEnabled 是否允许返回过期ip

public static List<string> getIpsByCacheWithDomain(string host, bool expiredIPEnabled)

15. 直接从缓存中获取ipv4解析结果，无需等待. 如无缓存，或有缓存但已过期，并且expiredIPEnabled为false，则返回空。

@param host 域名

@expiredIPEnabled 是否允许返回过期ip

public static List<string> getIpv4ByCacheWithDomain(string host, bool expiredIPEnabled)

16. 直接从缓存中获取ipv6解析结果，无需等待. 如无缓存，或有缓存但已过期，并且expiredIPEnabled为false，则返回空。

@param host 域名

@expiredIPEnabled 是否允许返回过期ip

public static List<string> getIpv6ByCacheWithDomain(string host, bool expiredIPEnabled)

17. 获取请求阿里公共DNS成功失败统计信息。

public static string getRequestReportInfo()