Версия: 3.12.0

Разработка приложений для iOS

В данном туториале Вы найдете информацию о том, как интегрировать Face SDK в базовое приложение в XCode. Созданное демо-приложение позволит оценить такие функции Face SDK, как инициализация работы с библиотекой libfacerec и определение антропометрических точек лица на фотографии.

Готовый демо-проект вы можете найти в дистрибутиве Face SDK: examples/tutorials/ios_minimal_project

Примечание: Минимальная поддерживаемая версия iOS – 11.4.

Скачайте и распакуйте дистрибутив, как описано в пункте Приступая к работе.
Создайте новый проект в XCode: File > New > Project. Выберите тип приложения Single View App. Настройки проекта – по умолчанию. Выберите директорию, в которой будет храниться проект.
Добавьте в приложение фреймворк facerec: в настройках проекта выберите General > Embedded Binaries > + > Add Other...> выберите директорию facerec.framework из распакованного дистрибутива. В группе Destination галочку Copy items if needed ставить необязательно. После этого нажмите Finish.

По умолчанию фреймворк автоматически добавляется в Linked Frameworks. Удалите фреймворк из этого списка (связывание библиотек на данном этапе сборки не требуется, поскольку библиотека facerec загружается во время выполнения).
Добавьте в проект папки из дистрибутива с необходимыми файлами (conf, license, share). В настройках проекта выберите Build Phases > + New Copy Files Phase > Copy Files > + > Add Other... > выделите папки conf, license, share. В группе Destination галочку Copy items if needed ставить необязательно. После этого нажмите Finish.

Укажите путь до заголовочных файлов из дистрибутива. В настройках проекта выберите Build Settings > Search Paths > Header Search Paths > сделайте двойной клик левой кнопкой мыши и перетащите папку include из дистрибутива.
Укажите поддерживаемую архитектуру: Architectures > Valid Architectures > arm64.
Отредактируйте созданный проект. Откройте файл main.m и укажите язык в настройках: Identity and Type > Type > Objective-C++ Source.
Отредактируйте код main.m, как показано в примере ниже.

#import <UIKit/UIKit.h>
#import "AppDelegate.h"


#include "pbio/FacerecService.h"

#include <vector>
#include <fstream>
#include <iostream>


BOOL copyLicense(NSString *srcDir, NSString *dstDir)
{
    NSString *dstLicenseFile = [dstDir stringByAppendingPathComponent:@"3divi_face_sdk.lic"];
    NSFileManager* fileMgr = [NSFileManager defaultManager];
    if ([fileMgr fileExistsAtPath:dstLicenseFile])
    {
        NSLog(@"The license file already exists in the target directory");
        return YES;
    }

    NSError *error;
    // create destination directory
    if (![fileMgr createDirectoryAtPath:dstDir
        withIntermediateDirectories:YES
        attributes:nil
        error:&error])
    {
        NSLog(@"Create license directory error: %@", error);
        return NO;
    }

    // copy license and config files
    if (![fileMgr copyItemAtPath:[srcDir stringByAppendingPathComponent:@"3divi_face_sdk.lic"]
        toPath:dstLicenseFile
        error:&error])
    {
        NSLog(@"Copy file error: %@", error);
        return NO;
    }
    if (![fileMgr copyItemAtPath:[srcDir stringByAppendingPathComponent:@"net_params.xml"]
        toPath:[dstDir stringByAppendingPathComponent:@"net_params.xml"]
        error:&error])
    {
        NSLog(@"Copy file error: %@", error);
        return NO;
    }
    if (![fileMgr copyItemAtPath:[srcDir stringByAppendingPathComponent:@"log_params.xml"]
        toPath:[dstDir stringByAppendingPathComponent:@"log_params.xml"]
        error:&error])
    {
        NSLog(@"Copy file error: %@", error);
        return NO;
    }

    return YES;
};


int main(int argc, char * argv[]) {

    std::cout << "Start application" << std::endl;

    std::cout << "Copy license to writable directory" << std::endl;
    // FaceSDK requires write permission to the license directory
    // copy the license from the resource directory to the application support directory
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSApplicationSupportDirectory, NSUserDomainMask, YES);
    NSString *applicationSupportDirectory = [paths firstObject];
    NSString *dstLicenseDir = [applicationSupportDirectory  stringByAppendingPathComponent:@"license"];
    NSString *srcLicenseDir = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"license"];
    if(!copyLicense(srcLicenseDir, dstLicenseDir))
    {
        std::cout << "Something went wrong while copying the license to a writable location" << std::endl;
        return -1;
    };

    const std::string frameworks_dir = [[[NSBundle mainBundle] privateFrameworksPath] UTF8String];
    const std::string resources_dir = [[[NSBundle mainBundle] resourcePath] UTF8String];

    std::cout << "Create FacerecService" << std::endl;
    const pbio::FacerecService::Ptr service = pbio::FacerecService::createService(
        frameworks_dir + "/facerec.framework/libfacerec.dylib",
        resources_dir + "/conf/facerec",
        [dstLicenseDir UTF8String]);

    std::cout << "Get license state" << std::endl;
    const pbio::FacerecService::LicenseState ls = service->getLicenseState();
    std::cout << "ls.online         : "  << ls.online         << std::endl;
    std::cout << "ls.android_app_id : "  << ls.android_app_id << std::endl;
    std::cout << "ls.ios_app_id     : "  << ls.ios_app_id     << std::endl;
    std::cout << "ls.hardware_reg   : "  << ls.hardware_reg   << std::endl;

    std::cout << "Create Capturer" << std::endl;
    const pbio::Capturer::Ptr capturer = service->createCapturer("fda_fake_detector_singleface.xml");

    std::cout << "Read image" << std::endl;
    std::vector<char> bytes;
    std::ifstream file((resources_dir + "/01100.jpg").c_str(), std::ios_base::binary);
    file.seekg(0, file.end);
    bytes.resize(file.tellg());
    file.seekg(0, file.beg);
    file.read(bytes.data(), bytes.size());
    file.close();


    std::cout << "Detect faces" << std::endl;
    const std::vector<pbio::RawSample::Ptr> samples = capturer->capture((const unsigned char*)bytes.data(), bytes.size());

    std::cout << samples.size() << " faces detected" << std::endl;

    for(const pbio::RawSample::Ptr &sample : samples)
    {
        const std::vector<pbio::Point> pts = sample->getLandmarks();
        for(const pbio::Point &p : pts)
            std::cout << "(" << p.x << ", " << p.y << "), ";
        std::cout << std::endl;
    }

    std::cout << "Done" << std::endl;

    @autoreleasepool {
        return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
    }
}

Для проверки работы демо используем фотографию лица. Вы можете использовать наш пример (путь до фото: bin/set1/01100.jpg), либо загрузить свое изображение. Добавьте фото в проект: Copy Files > + > Add Other... > укажите путь до изображения. В коде также укажите путь в строке resources_dir + ...

Подключите Ваше iOS-устройство к компьютеру и соберите приложение (нажмите на кнопку Run). В случае возникновения ошибки (см. изображение ниже) подтвердите сертификат разработчика на iOS-устройстве.

Вывод проекта должен быть аналогичен указанному на изображении ниже: