---

👓LGlassesKit_iOS

LGlassesKit_iOS 为智能眼镜的iOS框架，负责与智能眼镜设备通信等功能的封装。

兼容性（XCFramework）

支持 iOS 14.0 及以上操作系统

⚠️请仔细阅读 README 集成SDK；参考提供的示例 Demo，以帮助您更好地理解 API 的使用！

---

一、安装（CocoaPods）

1. 在 Podfile 中添加

pod 'LGlassesKit_iOS', git: 'https://github.com/wsr1949/LGlassesKit_iOS.git'

2. 终端执行

pod install

二、Info.plist 添加隐私权限描述

1. 蓝牙权限

Privacy - Bluetooth Always Usage Description

2. 本地网络权限

Privacy - Local Network Usage Description

三、TARGRTS 添加 Capability

1. 访问Wi-Fi信息

Access Wi-Fi Information

2. 热点

Hotspot

3. 扩展虚拟地址（可选）

Extended Virtual Addressing

4. 后台模式Background Modes勾选

Uses Bluetooth LE accessories

---

🎉开始使用

一、导入头文件

#import <LGlassesKit_iOS/LGlassesKit_iOS.h>

二、初始化SDK（详阅LGlassesKit.h）注册委托代理

注册委托代理

/**
 注册委托代理
 @param delegate    委托代理
 @param enableLog   是否开启日志 详@link 委托代理方法 notifySdkLog:
 */
+ (void)registerDelegate:(id <LDelegate> _Nonnull)delegate enableLog:(BOOL)enableLog;

三、实现委托代理方法

中心蓝牙状态

/**
 中心蓝牙状态
 @param status      蓝牙状态
 */
- (void)centralBluetoothStatus:(CBManagerState)status;

BLE连接状态

/**
 BLE连接状态
 @param status      ble状态
 @param error       错误
 */
- (void)bleConnectionStatus:(LBleStatus)status error:(NSError * _Nullable)error;

SDK日志，enableLog需要设置开启

/**
 SDK日志，enableLog需要设置开启
 @param logText     日志
 */
- (void)notifySdkLog:(NSString * _Nullable)logText;

每次拍照或录像成功，通知缩略图数量

/**
 每次拍照或录像成功，通知缩略图数量
 @param count       数量
 */
- (void)notifyThumbnailsCount:(NSInteger)count;

通知Wi-Fi热点名称

/**
 通知Wi-Fi热点名称
 @param wifiHotspotName     Wi-Fi热点名称
 */
- (void)notifyWifiHotspotName:(NSString * _Nullable)wifiHotspotName;

Wi-Fi热点连接状态

/**
 Wi-Fi热点连接状态
 @param status      Wi-Fi状态
 @param error       错误
 */
- (void)wifiHotspotConnectionStatus:(LWiFiHotspotStatus)status error:(NSError * _Nullable)error;

通知设备电池电量信息

/**
 通知设备电池电量信息
 @param batteryModel        电池电量信息
 */
- (void)notifyDeviceBatteryInfo:(LBatteryModel * _Nonnull)batteryModel;

通知AI语音助手状态

/**
 通知AI语音助手状态
 @param activated   激活状态，YES激活 NO未激活
 */
- (void)notifyAIVoiceAssistantStatus:(BOOL)activated;

通知语音数据

/**
 通知语音数据
 @param voiceData   语音数据（opus格式）
 */
- (void)notifyVoiceData:(NSData * _Nullable)voiceData;

通知AI识图照片数据

/**
 通知AI识图照片数据
 @param photoData   图片数据（JPG格式）
 @param error       错误
 */
- (void)notifyAIRecognizePhotoData:(NSData * _Nullable)photoData error:(NSError * _Nullable)error;

通知停止语音识别

/**
 通知停止语音识别
 */
- (void)notifyStopSpeechRecognition;

通知停止语音播报

/**
 通知停止语音播报
 */
- (void)notifyStopVoicePlayback;

通知拍照状态

/**
 通知拍照状态
 @param activated   激活状态，YES激活 NO未激活
 */
- (void)notifyDevicePhotoTakingStatus:(BOOL)activated;

通知录音状态

/**
 通知录音状态
 @param activated   激活状态，YES激活 NO未激活
 */
- (void)notifyAudioRecordingStatus:(BOOL)activated;

通知录像状态

/**
 通知录像状态
 @param activated   激活状态，YES激活 NO未激活
 */
- (void)notifyVideoRecordingStatus:(BOOL)activated;

通知设备佩戴状态

/**
 通知设备佩戴状态
 @param wearing     佩戴状态，YES佩戴 NO未佩戴
 */
- (void)notifyDeviceWearingStatus:(BOOL)wearing;

四、命令方法

开始扫描设备

/**
 开始扫描设备
 @param callback            设备扫描回调
 @param timeout             扫描超时时间，秒
 @param broadcastAnalysis   是否解析广播，YES解析成功才回调，NO不解析广播数据直接回调
 */
+ (void)startScanningWithCallback:(LDiscoverPeripheralCallback _Nonnull)callback timeout:(int)timeout broadcastAnalysis:(BOOL)broadcastAnalysis;

停止扫描设备

/**
 停止扫描设备
 */
+ (void)stopScanning;

连接设备

/**
 连接设备
 @param uuid        设备UUID
 @param timeout     连接超时时间，秒
 @note  连接结果通过委托代理LDelegate返回 详@link bleConnectionStatus:error:
 */
+ (void)connectingDevice:(NSString * _Nonnull)uuid timeout:(int)timeout;

断开设备连接

/**
 断开设备连接
 */
+ (void)disconnectDevice;

中心蓝牙状态

/**
 中心蓝牙状态
 @return    中心蓝牙状态
*/
+ (CBManagerState)centralManagerState;

BLE连接状态

/**
 BLE连接状态
 @return    BLE连接状态
 */
+ (LBleStatus)bleConnectStatus;

设置系统时间

/**
 设置系统时间
 */
+ (void)setSystemTimeWithCallback:(LResultCallback _Nonnull)callback;

设置LED亮度

/**
 设置LED亮度
 @param brightness  led亮度
 */
+ (void)setLEDBrightness:(LLedBrightness)brightness callback:(LResultCallback _Nonnull)callback;

设置录像时长

/**
 设置录像时长
 @param duration    录制时长，秒
 */
+ (void)setVideoRecordingDuration:(NSInteger)duration callback:(LResultCallback _Nonnull)callback;

设置佩戴检测

/**
 设置佩戴检测
 @param open    是否开启佩戴检测
 */
+ (void)setWearDetection:(BOOL)open callback:(LResultCallback _Nonnull)callback;

设置语音唤醒

/**
 设置语音唤醒
 @param open    是否开启语音唤醒
 */
+ (void)setVoiceWakeUp:(BOOL)open callback:(LResultCallback _Nonnull)callback;

设置快捷手势功能

/**
 设置快捷手势功能
 @param action  快捷手势
 @param event   手势功能
 */
+ (void)setGesturesAction:(LGestureActions)action event:(LGestureEvents)event callback:(LResultCallback _Nonnull)callback;

重置快捷手势功能

/**
 重置快捷手势功能
 */
+ (void)resetGesturesActionWithCallback:(LResultCallback _Nonnull)callback;

设置久坐提醒

/**
 设置久坐提醒
 @param duration    久坐时长，分钟
 */
+ (void)setSedentaryReminderTime:(NSInteger)duration callback:(LResultCallback _Nonnull)callback;

重启设备

/**
 重启设备
 */
+ (void)setRestartDeviceWithCallback:(LResultCallback _Nonnull)callback;

恢复出厂设置

/**
 恢复出厂设置
 */
+ (void)setFactoryResetWithCallback:(LResultCallback _Nonnull)callback;

获取设备电池电量

/**
 获取设备电池电量
 */
+ (void)getDeviceBatteryWithCallback:(LBatteryCallback _Nonnull)callback;

开启拍照

/**
 开启拍照
 @param type    拍照类型，当类型为LPhotoType_PhotoRecognition时，成功拍照后图片会通过委托代理LDelegate返回 详@link notifyAIRecognizePhotoData:
 */
+ (void)startTakingPhotos:(LPhotoType)type callback:(LResultCallback _Nonnull)callback;

照片拍摄模式

/**
 照片拍摄模式
 @param mode    拍照模式
 */
+ (void)setPhotoShootingMode:(LPhotoMode)mode callback:(LResultCallback _Nonnull)callback;

设置拍摄方向

/**
 设置拍摄方向
 @param direction    拍摄方向
 */
+ (void)setShootingDirection:(LShootingDirection)direction callback:(LResultCallback _Nonnull)callback;

开启录像

/**
 开启录像
 */
+ (void)startVideoRecordingWithCallback:(LResultCallback _Nonnull)callback;

停止录像

/**
 停止录像
 */
+ (void)stopVideoRecordingWithCallback:(LResultCallback _Nonnull)callback;

开启录音

/**
 开启录音
 */
+ (void)startAudioRecordingWithCallback:(LResultCallback _Nonnull)callback;

停止录音

/**
 停止录音
 */
+ (void)stopAudioRecordingWithCallback:(LResultCallback _Nonnull)callback;

获取设备控制参数

/**
 获取设备控制参数
 */
+ (void)getDeviceControlParamWithCallback:(LDeviceControlParamCallback _Nonnull)callback;

获取设备版本

/**
 获取设备版本
 */
+ (void)getDeviceVersionWithCallback:(LDeviceVersionCallback _Nonnull)callback;

中断语音传输

/**
 中断语音传输
 */
+ (void)abortVoiceTransmissionWithCallback:(LResultCallback _Nonnull)callback;

恢复语音传输

/**
 恢复语音传输
 */
+ (void)resumeVoiceTransmissionWithCallback:(LResultCallback _Nonnull)callback;

获取当前文件(缩略图)数量

/**
 获取当前文件(缩略图)数量
 @note 获取成功后数量会通过委托代理LDelegate返回 详@link notifyThumbnailsCount:
 */
+ (void)getThumbnailsCountWithCallback:(LResultCallback _Nonnull)callback;

打开Wi-Fi�热点

/**
 打开Wi-Fi�热点
 @note Wi-Fi热点成功打开后名称会通过委托代理LDelegate返回 详@link notifyWifiHotspotName:
 */
+ (void)openWifiHotspotWithCallback:(LResultCallback _Nonnull)callback;

连接Wi-Fi热点

/**
 连接Wi-Fi热点
 @param wifiHotspotName    Wi-Fi热点名称
 @note  连接结果通过委托代理LDelegate返回 详@link wifiHotspotConnectionStatus:error:
 */
+ (void)connectingWiFiHotspot:(NSString * _Nonnull)wifiHotspotName;

断开Wi-Fi热点连接

/**
 断开Wi-Fi热点连接
 */
+ (void)disconnectWiFiHotspot;

Wi-Fi热点连接状态

/**
 Wi-Fi热点连接状态
 @return    Wi-Fi热点连接状态
 */
+ (LWiFiHotspotStatus)wifiHotspotStatus;

请求文件列表

/**
 请求文件列表
 */
+ (void)requestFileListWithCallback:(LFileListCallback _Nonnull)callback;

文件下载

/**
 文件下载
 @param fileName    文件名称
 */
+ (void)downloadFile:(NSString * _Nonnull)fileName progressCallback:(LProgressCallback _Nonnull)progressCallback completeCallback:(LDownloadCallback _Nonnull)completeCallback;

文件删除

/**
 文件删除
 @param filePath    文件路径
 */
+ (void)deleteFile:(NSString * _Nonnull)filePath callback:(LResultCallback _Nonnull)callback;

上报文件下载个数

/**
 上报文件下载个数
 @param count    已下载个数
 */
+ (void)reportFileDownloadsCount:(NSInteger)count callback:(LResultCallback _Nonnull)callback;

🚀开始OTA升级

/**
 🚀开始OTA升级
 @param filePath                    ota文件本地路径
 @param isRestoreUpgrade            恢复OTA升级，true恢复升级，false正常升级
 @param restoreReconnectMethod      恢复OTA升级的设备回连方式，isRestore==true时（必填）使用正确的回连方式；isRestore==false时则使用None即可
 @param restoreReconnectDevice      恢复OTA升级的设备，isRestore==true时（必填）使用正确的设备；isRestore==false时则传nil即可
 @param preparingProgressCallback   ota准备进度回调
 @param reconnectCallback           ota设备回连回调
 @param upgradeProgressCallback     ota升级进度回调
 @param upgradeResultCallback       ota升级结果回调
 @param restartCallback             ota设备重启回调
 */
+ (void)startOtaUpgradeWithFilePath:(NSString * _Nonnull)filePath
                   isRestoreUpgrade:(BOOL)isRestoreUpgrade
               restoreReconnectMethod:(LOtaUpgradeReconnectMethod)restoreReconnectMethod
             restoreReconnectDevice:(NSString * _Nullable)restoreReconnectDevice
          preparingProgressCallback:(LOtaUpgradeProgressCallback _Nonnull)preparingProgressCallback
                  reconnectCallback:(LOtaUpgradeReconnectCallback _Nonnull)reconnectCallback
            upgradeProgressCallback:(LOtaUpgradeProgressCallback _Nonnull)upgradeProgressCallback
              upgradeResultCallback:(LResultCallback _Nonnull)upgradeResultCallback
                    restartCallback:(void (^ _Nonnull)(void))restartCallback;

进入ISP升级模式🚀

/**
 进入ISP升级模式🚀
 @note 进入ISP升级模式会自动打开Wi-Fi热点，Wi-Fi热点成功打开后名称会通过委托代理LDelegate返回 详@link notifyWifiHotspotName:
 */
+ (void)enableIspUpgradeModeWithCallback:(LResultCallback _Nonnull)callback;

🚀开始ISP升级（需要先打开并连接Wi-Fi热点）

/**
 🚀开始ISP升级（需要先进入ISP升级模式，并连接Wi-Fi热点）
 @param filePath                    isp文件本地路径
 @param ispVersion                  isp版本号，格式x.x.x
 @param upgradeProgressCallback     isp升级进度回调
 @param upgradeResultCallback       isp升级结果回调
 @note 先进入ISP升级模式，成功连接Wi-Fi热点后，再开始ISP升级
 */
+ (void)startIspUpgradeWithFilePath:(NSString * _Nonnull)filePath
                         ispVersion:(NSString * _Nonnull)ispVersion
            upgradeProgressCallback:(LOtaUpgradeProgressCallback _Nonnull)upgradeProgressCallback
              upgradeResultCallback:(LResultCallback _Nonnull)upgradeResultCallback;

设置离线语音语种

/**
 设置离线语音语种
 */
+ (void)setOfflineVoiceLanguage:(LOfflineVoiceLanguage)language callback:(LResultCallback _Nonnull)callback;

---

版本记录🚀

 project    2026-01-06  Version:1.0.5   Build:2026010601
            1.修复已知解析错误BUG

 project    2026-01-05  Version:1.0.4   Build:2026010501
            1.更新「开始扫描设备」方法 startScanningWithCallback:timeout:broadcastAnalysis: 新增broadcastAnalysis是否解析广播，YES解析成功才回调，NO不解析广播数据直接回调

 project    2025-12-22  Version:1.0.3   Build:2025122201
            1.更新OTA升级方法（LGlassesKit）startOtaUpgradeWithFilePath...
                - 增加 isRestoreUpgrade 恢复OTA升级，true恢复升级，false正常升级
                - 增加 restoreReconnectMethod 恢复OTA升级的设备回连方式，isRestore==true时（必填）使用正确的回连方式；isRestore==false时则使用None即可
                - 增加 restoreReconnectDevice 恢复OTA升级的设备，isRestore==true时（必填）使用正确的设备；isRestore==false时则传nil即可
                - 修改 reconnectCallback 设备回连回调，增加 reconnectMethod 回连方式、reconnectDevice 回连设备
            2.更新ISP升级方法（LGlassesKit）startIspUpgradeWithFilePath...
                - 增加 ispVersion 升级版本号
                - 移除 restartCallback 重启回调，升级成功设备不会重启

 project    2025-12-15  Version:1.0.2   Build:2025121501
            1.新增委托代理方法 @link LDelegate
                通知拍照状态 notifyDevicePhotoTakingStatus:
                通知录音状态 notifyAudioRecordingStatus:
                通知录像状态 notifyVideoRecordingStatus:
                通知设备佩戴状态 notifyDeviceWearingStatus:
            2.新增进入ISP升级模式方法（LGlassesKit）enableIspUpgradeModeWithCallback:
            3.更新OTA升级方法（LGlassesKit）startOtaUpgradeWithFilePath...
            4.更新ISP升级方法（LGlassesKit）startIspUpgradeWithFilePath...
            5.新增设置离线语音语种方法（LGlassesKit）setOfflineVoiceLanguage:
            6.其他已知问题优化

 project    2025-11-25  Version:1.0.1   Build:2025112501
            1.新增区分Ble连接失败状态（LMacro）LBleStatusConnectionFailed
            2.新增区分Wi-Fi连接失败状态（LMacro）LWiFiHotspotStatusConnectionFailed
            3.新增OTA升级方法（LGlassesKit）startOtaUpgradeWithFilePath...
            4.新增ISP升级方法（LGlassesKit）startIspUpgradeWithFilePath...

 project    2025-10-13  Version:1.0.0   Build:2025091901
            1.首版