解锁全球连接：快速搞定国际卡APN设置

告别繁琐的网络配置！只需5分钟，轻松完成国际卡APN设置，瞬间突破地域限制，随时随地接入国际网络，工作旅行两不误。

APN是设备连接到运营商网络的“身份证”——当设备插入SIM卡并注册到运营商网络时，网络侧会检查设备发送的APN信息，从而确定为设备提供哪种类型的网络连接和服务质量等级。

一、APN基础知识

APN（Access Point Name）—— 是一种网络接入技术，终端模组在接入到网络时必须配置该参数，该参数决定了模组以何种方式接入网络；用户在上网时，针对不同的APN，核心网网元GGSN/P-GW将会把用户转接代理到不同的网络。

在LuatOS开发中，如需通过模组设置APN，所设置的APN要与SIM卡开卡时配置的APN一致。

1.1 什么情况下需要配置APN

如果是专网卡，首先咨询SIM卡供应商APN参数，然后在main.lua尽可能靠前的位置调用接口进行设置。

如果是公网卡，不需要用户主动设置APN，软件自动去网络端查询APN进行设置。

1.2 如何区分专网卡和公网卡

根据使用的网络类型来分，SIM卡可以分为公网卡和专网卡两种。可按照如下顺序判断确认：

咨询SIM卡供应商；

如果APN有账号、或者有密码、或者有加密类型，则可以认为是专网卡。

如果使用专网卡，需要先将访问的域名或IP加入专网卡白名单。以下是相关应用中，模组会访问的域名或IP服务器：

1.3 国内与国外APN配置差异

在国内，三大运营商的公网卡大多支持即插即用，模组可以自动获取APN设置。而在海外，大多数运营商都需要手动配置APN，这也是许多国内设备出海时遇到联网问题的主要原因。

需要特别注意的是：绝对不要在国内测试好后直接发到国外使用，必须进行本地化测试。

二、Air795UG国际卡APN配置示例

Air795UG是全球通模组，支持全球主流运营商主流频段，支持4G/2G双模，支持双卡单待，支持LuatOS开发。

全球通Air795UG最新资料下载：https://docs.openluat.com/air795ug/product/shouce/

2.1 相关硬件准备

Air795UG开发板：

支持数据传输的USB数据线；

具备国际漫游功能的SIM卡；

Win10及其以上PC电脑。

2.2 API接口说明

LuatOS提供了便捷的API接口，可以帮助你快速配置APN。

最新API说明详见：

https://docs.openluat.com/osapi/core/mobile/

mobile.apnTableInit()

初始化自定义APN列表，主要用于海外SIM卡，无返回值。

mobile.apnTableAdd(mcc, mnc, ip_type, protocol, apn_name, user_name, password)

往自定义APN列表添加一条APN信息，主要用于海外SIM卡，相关参数说明如下表所示。

2.3 示例代码说明

国际卡APN配置示例代码如下图示，注意具体参数需要根据实际情况，跟卡商确认后填写正确信息。

2.4 示例功能验证：

Air795UG开发板通过LuaTools烧录内核固件和demo脚本代码，烧录成功后开机运行，即可查看国际卡APN配置结果。

如下图示：

今天的内容就分享到这里了~

审核编辑 黄宇