👓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 status     状态
 */
- (void)notifyDeviceOtherStatus:(LOtherStatus)status;

通知设备音乐播放状态

/**
 通知设备音乐播放状态
 @param playing     音乐播放状态，YES播放 NO暂停
 */
- (void)notifyDeviceMusicPlayingStatus:(BOOL)playing;

通知设备佩戴状态

/**
 通知设备佩戴状态
 @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    文件名称
 @param targetUrl   下载至本地目标地址
 */
+ (void)downloadFile:(NSString * _Nonnull)fileName targetUrl:(NSURL * _Nonnull)targetUrl progressCallback:(LDownloadProgressCallback _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-02-02  Version:1.0.6   Build:2026020201
            1.优化下载方法，支持本地目标地址 详@link downloadFile:targetUrl:progressCallback:completeCallback
            2.新增委托代理方法 详@link LDelegate
                通知设备其他状态 notifyDeviceOtherStatus:
                通知设备音乐播放状态 notifyDeviceMusicPlayingStatus:
            3.修复已知解析错误BUG

 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.首版

Name		Name	Last commit message	Last commit date
Latest commit History 84 Commits
LGlassesKit_iOS_Demo		LGlassesKit_iOS_Demo
Resources		Resources
XCFramework		XCFramework
LGlassesKit_iOS.podspec		LGlassesKit_iOS.podspec
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

👓LGlassesKit_iOS

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

兼容性（XCFramework）

支持 iOS 14.0 及以上操作系统

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

一、安装（CocoaPods）

1. 在 Podfile 中添加

2. 终端执行

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

1. 蓝牙权限

2. 本地网络权限

三、TARGRTS 添加 Capability

1. 访问Wi-Fi信息

2. 热点

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

4. 后台模式Background Modes勾选

🎉开始使用

一、导入头文件

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

注册委托代理

三、实现委托代理方法

中心蓝牙状态

BLE连接状态

SDK日志，enableLog需要设置开启

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

通知Wi-Fi热点名称

Wi-Fi热点连接状态

通知设备电池电量信息

通知AI语音助手状态

通知语音数据

通知AI识图照片数据

通知停止语音识别

通知停止语音播报

通知拍照状态

通知录音状态

通知录像状态

通知设备其他状态

通知设备音乐播放状态

通知设备佩戴状态

四、命令方法

开始扫描设备

停止扫描设备

连接设备

断开设备连接

中心蓝牙状态

BLE连接状态

设置系统时间

设置LED亮度

设置录像时长

设置佩戴检测

设置语音唤醒

设置快捷手势功能

重置快捷手势功能

设置久坐提醒

重启设备

恢复出厂设置

获取设备电池电量

开启拍照

照片拍摄模式

设置拍摄方向

开启录像

停止录像

开启录音

停止录音

获取设备控制参数

获取设备版本

中断语音传输

恢复语音传输

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

打开Wi-Fi�热点

连接Wi-Fi热点

断开Wi-Fi热点连接

Wi-Fi热点连接状态

请求文件列表

文件下载

文件删除

支持 `iOS 14.0 及以上操作系统`

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

1. 在 `Podfile` 中添加

4. 后台模式`Background Modes`勾选

Packages