360 VR SDK

这是一个小型的VR库，可以快速帮助你构建VR应用程序。（项目包含ijkplayer framework 和资源，所以项目有点大，请耐心下载！）（项目约150MB，sdk实际大小为9Mb） This is a small VR library that can quickly help you build VR app. (As the project contains the ijkplayer framework and resources, so the project a little big, please be patient to download!)(About 150Mb)

Warning

不支持模拟器，请在真机下测试。（模拟器下会报错） not support the simulator,Please run on a real machine. (the simulator will make a mistake.)

Example Preview

How to use vr sdk? - See：GongFu SDK 1.14.pdf

   SZTLibrary.h

    // create sdk based on Controller
    self.sztLibrary = [[SZTLibrary alloc] initWithController:self];
    
    or
    // create sdk based on view
    self.sztLibrary = [[SZTLibrary alloc] initWithView:self.view];

1、AVPlayer - 模式切换／滤波器切换 (change Render Model/change Filter)

2、ijkPlayer

// Render Model
typedef NS_ENUM(NSInteger, SZTRenderModel) {
    SZTVR_2D,                                   // 2d
    SZTVR_SPHERE,                               // 全景
    SZTVR_STEREO_HEMISPHERE,                    // 3D180(左右格式)
    SZTVR_STEREO_SPHERE,                        // 立体全景(上下格式)
    SZTVR_PLANE,                                // 平面
    SZTVR_DOME180,                              // 圆顶180
    SZTVR_STEREO_PLANE_LEFT_RIGHT,              // 立体平面 - 上下
    SZTVR_STEREO_PLANE_UP_DOWN,                 // 立体平面 - 左右
    SZTVR_FISHSPHERE_HIGH,                      // 960 * 2560
    SZTVR_FISHSPHERE_RETINA_HIGH,               // 1520 * 2688
    SZTVR_FISHSPHERE_MEDIUM,                    // 960 * 1920
    SZTVR_FISHSPHERE_RETINA_MEDIUM,             // 1080 * 1920
    SZTVR_3D_MODEL,                             // 3D模型
    SZTVR_CURVEDSURFACE,                        // 曲面屏幕 - 不规则曲面(5面)
    SZTVR_SECTOR,                               // 扇形曲面 - 平滑曲面
};

// Filter Mode
typedef NS_ENUM(NSInteger, SZTFilterMode) {
    SZTVR_NORMAL,           // 普通
    SZTVR_LUMINANCE,        // 像素色值亮度平均，图像黑白 (黑白效果)
    SZTVR_PIXELATE,         // 马赛克
    SZTVR_EXPOSURE,         // 曝光 (美白)
    SZTVR_DISCRETIZE,       // 离散
    SZTVR_BLUR,             // 模糊
    SZTVR_BILATERAL,        // 双边模糊
    SZTVR_HUE,              // 饱和度 
    SZTVR_POLKADOT,         // 像素圆点花样
    SZTVR_GAMMA,            // 伽马线
    SZTVR_GLASSSPHERE,      // 水晶球效果
    SZTVR_CROSSHATCH,       // 法线交叉线
};

3、单双屏切换

typedef NS_ENUM(NSInteger, SZTModeDisplay) {
    SZTModeDisplayNormal,   // 普通模式
    SZTModeDisplayGlass,    // 分屏模式
};


/**
 * 设置单双屏幕模式  － 默认分屏
 */
- (void)dispalyMode:(SZTModeDisplay)mode;

// 使用方法
[self.SZTLibrary dispalyMode:SZTModeDisplayNormal];

4、陀螺仪/触摸/陀&触 (gyroscope or touch)

sdk集成了gvr处理陀螺仪数据的方法，效果更好。

typedef NS_ENUM(NSInteger, SZTSensorMode) {
    SZTSensorNormal,       // 系统默认处理
    SZTSensorGvr,          // gvr陀螺仪处理（有跟随效果）
};

typedef NS_ENUM(NSInteger, SZTModeInteractive) {
    SZTModeInteractiveTouch,            // 触摸
    SZTModeInteractiveMotion,           // 陀螺仪
    SZTModeInteractiveMotionWithTouch,  // 陀螺仪和触摸
};

/**
 * 设置交互模式  － 默认陀螺仪
 */
- (void)interactiveMode:(SZTModeInteractive)mode;

// 使用方法
[self.SZTLibrary interactiveMode:SZTModeInteractiveMotion];

5、移动／缩放／旋转／贝塞尔 (animation - moveTo/scaleTo/rotateTo/bezierTo)

6、图片加载 - 网络／本地图 (load image by local path or url)

7、Gif / APng动图加载 (load gif or aPng)

8、Obj模型加载 / MD2模型加载 (load Obj model or MD2 model)

9、3D立体音效 - openAl (3d sound, use openAl)

    SZTAudio * audio = [[SZTAudio alloc] init];
    
    NSString* path = [[NSBundle mainBundle] pathForResource:@"sound1" ofType:@"wav"];
    Sound *sounds = [[Sound alloc] initWithFilePath:path];
    [audio addSubAudio:sounds];
    [sounds setPosition:0.0 Y:0.0 Z:-50.0];

10、畸变矫正 (distortion correction)

typedef NS_ENUM(NSInteger, SZTDistortion) {
    SZTDistortionNormal,   // 无畸变
    SZTBarrelDistortion,   // 桶形畸变模式
};

/**
 * 畸变模式 - 默认无畸变
 */
- (void)distortionMode:(SZTDistortion)mode;

// 使用方法
[self.SZTLibrary distortionMode:SZTDistortionNormal];

11、Label控件/大量弹幕 (load label, barrage)

12、进度条控件 （load Progress bar）

13、焦点拾取/点击拾取 （ray picking/touch picking）

    // 要使用热点拾取功能，一定需要设置该接口
    [self.sztLibrary setFocusPicking:YES];
     
    // 热点拾取方法   object为要被拾取的对象
    SZTTouch *touch = [[SZTTouch alloc] initWithTouchObject:object];
    
    // 拾取的三个状态
    [touch willTouchCallBack:^(GLKVector3 vec) {
        NSLog(@"will select");
    }];
    
    [touch didTouchCallback:^(GLKVector3 vec) {
        NSLog(@"select");
    }];
    
    [touch endTouchCallback:^(GLKVector3 vec) {
        NSLog(@"will leave");
    }];

14、输入框控件 (keyboard bar)

15、更多高级控件 (more)

1、粒子系统 2、环形控件 3、九宫格控件，根据头距自动上下滑动 4、耳机线控拾取 5、储物盒控件 6、视频预览控件（基于九宫格）

功能不一一展示在这里了，有需要的加群讨论。

编辑json脚本，加载vr场景 （非程序员也可以编辑vr app）

    // create sdk
    self.sztLibrary = [[SZTLibrary alloc] initWithController:self];
    [self.sztLibrary setFocusPicking:YES]; // 开启热点交互
    
    /*** json 脚本****/
    NSString *path = [NSString stringWithFormat:@"%@/%@",SANDBOXPATH, @"supermarket.json"];
    
    script = [[ScriptUI alloc] initWithSandboxPath:path]; 
    [script setVideoPlayer:SZT_IJKPlayer]; // 脚本的播放器使用ijkplayer/avplayer
    [self.sztLibrary addSubObject:script];

脚本规范查看：http://www.vrkongfu.com/doc/doc_zh.html

项目测试：把脚本和资源放到app的根目录下 脚本和资源地址：https://pan.baidu.com/s/1skAdqHZ 脚本空模版：

Script specification：http://www.vrkongfu.com/doc/doc_en.html Project testing: Put scripts and resources in the root directory of app scripts and resources：https://pan.baidu.com/s/1skAdqHZ Template：

AR

Join us

我们会不定期的更新sdk，加入更多新功能，大家有新的需要或好的想法，欢迎大家加入群一起讨论。 We will update SDK regularly.Welcome to join the group for discussion.

• 邮箱 :[email protected]
• QQ 群 :174962747
• 公司地址 :http://www.arvrschool.com/

QQ Group