如何使用Xcode控制iPhone的flood illuminator LED开关

问题背景 #

基于BiometricKit.framework编写的flood illuminator控制程序无法正常生效，当前flood illuminator仅会在Face ID设置流程中自动开启，无法通过自定义代码主动触发开关。
原有实现代码如下：

Class BKDeviceManager = NSClassFromString(@"BKDeviceManager");
NSMutableArray *array = (NSMutableArray *)[BKDeviceManager availableDevices];
NSLog(@"manager availableDevices: %@", array);
            
Class BKDeviceDescriptor = NSClassFromString(@"BKDeviceDescriptor");
for (int i = 0; i < array.count; i++)
{
    id descriptor = [array objectAtIndex:i];
    NSLog(@"object: %@", descriptor);
}
if (array.count < 1)
    return;
id descriptor = [array objectAtIndex:0];
//Class BKDevice = NSClassFromString(@"BKDevice");
NSError *err = nil;
BKDevice *device = [BKDevice deviceWithDescriptor:descriptor error:&err];
NSLog(@"err: %@", err);
if (err)
{
    NSLog(@"err: %@", [err description]);
    return;
}
                       
NSLog(@"BKFaceDetectOperation: %@", NSClassFromString(@"BKFaceDetectOperation"));
Class BKFaceDetectOperation = NSClassFromString(@"BKFaceDetectOperation");
id object = [[BKFaceDetectOperation alloc] initWithDevice:device];
NSLog(@"object: %@ start Bio Operation", object);
[object startBioOperation:YES reply: ^{
     NSLog(@"This is a block startBioOperation reply run action");
}];

失效原因 #

• BiometricKit属于苹果私有框架，无公开API文档，所有硬件控制接口都有严格的权限、触发场景校验规则，普通沙盒环境下的第三方App无权限直接调用。
• 原有代码调用的startBioOperation:YES是Face ID检测流程的通用启动入口，并非单独控制flood illuminator开关的接口：该接口触发后系统会先校验生物识别权限、当前运行场景，只有在Face ID验证、人脸录入的系统级场景下才会点亮泛光元件，普通App进程调用会直接被系统拦截，不会触发硬件动作。
• 代码存在基础调用错误：BKDevice类未提前通过NSClassFromString获取，直接声明类型调用会触发消息转发异常，无法正确初始化生物识别设备实例。

可行实现方案（仅适用于越狱设备/内部调试场景，无法用于App Store上架） #

1. 配置运行权限：在工程entitlements文件中添加com.apple.private.biometrickit.allows权限并设为true，调试时需以root权限运行App，否则所有BiometricKit硬件控制调用都会被沙盒拦截。
2. 跳过Face ID检测流程，直接调用BKDevice的私有控制方法- (void)setFloodIlluminatorEnabled:(BOOL)enabled控制元件开关，修正后的核心代码如下：

// 提前加载BiometricKit相关类
Class BKDeviceManager = NSClassFromString(@"BKDeviceManager");
Class BKDevice = NSClassFromString(@"BKDevice");
if (!BKDeviceManager || !BKDevice) {
    NSLog(@"BiometricKit加载失败");
    return;
}
NSArray *availableDevices = [BKDeviceManager availableDevices];
if (availableDevices.count < 1) {
    NSLog(@"未检测到可用生物识别硬件");
    return;
}
NSError *initErr = nil;
id biometricDevice = [BKDevice deviceWithDescriptor:availableDevices.firstObject error:&initErr];
if (initErr || !biometricDevice) {
    NSLog(@"生物识别设备初始化失败: %@", initErr);
    return;
}
// 调用私有方法开启flood illuminator
SEL setFloodSelector = NSSelectorFromString(@"setFloodIlluminatorEnabled:");
if ([biometricDevice respondsToSelector:setFloodSelector]) {
    // 开启
    [biometricDevice performSelector:setFloodSelector withObject:@(YES)];
    // 示例：5秒后自动关闭
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(5 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        [biometricDevice performSelector:setFloodSelector withObject:@(NO)];
    });
}

3. 注意事项：
   • 该实现仅支持iOS 12及以上版本的Face ID机型，不同iOS版本的BiometricKit方法名可能存在差异，调用前必须做方法存在性校验，避免崩溃。
   • 非越狱环境下即使代码逻辑正确，也会因为沙盒权限、代码签名校验失败无法触发硬件动作。
   • 苹果禁止App调用私有API，使用上述代码的安装包提交App Store审核会直接被拒绝。

内容的提问来源于stack exchange，提问作者Duyet Le