iOS开发 触觉体验(UIFeedbackGenerator)的使用

1. 触感反馈的使用(UIFeedbackGenerator)

提示:UIFeedbackGenerator在 iOS 10.0 及更新版本可用。

1.1 触感反馈工具类 FeedbackGeneratorUtil 的使用流程
  1. 导入FeedbackGeneratorUtil类;
  2. 确定需要触感反馈的操作;
  3. 在操作事件中调用FeedbackGeneratorUtil的方法即可产生触感反馈。
1.2 触感反馈工具类 FeedbackGeneratorUtil 的使用方法
// 产生触感反馈,该方法默认为中度反馈
[FeedbackGeneratorUtil generateImpactFeedback];

// 根据传入的触感反馈类型产生触感反馈
[FeedbackGeneratorUtil generateImpactFeedbackWithStyle:UIImpactFeedbackStyleMedium];

2. 触感反馈使用建议

触感反馈强度 建议的操作 示例使用场景
UIImpactFeedbackStyleLight
轻度反馈
1. 选中操作
UITableView列表选中某一行时
登录、注册等页面,点击密码显示/隐藏按钮时
2. 成功操作
设备打开/关闭时
3. 失败操作
接口获取数据失败时
UIImpactFeedbackStyleMedium
中度反馈
1. 一般弹窗提示操作
点击退出登录按钮,弹出提示弹窗时
两次密码输入不一致,弹出提示弹窗时
2. 成功操作
扫码识别成功时
UIImpactFeedbackStyleHeavy
重度反馈
1. 删除操作
点击删除设备按钮,弹出提示弹窗时
点击注销账户按钮,弹出提示弹窗时

提示:示例使用场景,并不是每个场景都需要使用,可根据App使用体验自行决定何时、何地使用。

3. 触感反馈工具类 FeedbackGeneratorUtil 源代码

3.1 FeedbackGeneratorUtil.h

//
//  FeedbackGeneratorUtil.h
//
//  Created by wangzhi on 2022/7/15.
//

#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#import <AudioToolbox/AudioToolbox.h>

NS_ASSUME_NONNULL_BEGIN

@interface FeedbackGeneratorUtil : NSObject

// MARK: 添加触感反馈

/// 产生触感反馈效果
///
/// 1. iOS 13.0之前, 无强度参数 intensity
///
/// 2. iOS 13.0之后, 增加强度参数 intensity , 即可以指定触感反馈强度
///
///  - intensity 设置为0.0时, 无触感反馈
///
///  - intensity 设置为1.0时, 其强度等价于 iOS 13.0之前的无intensity时的强度
///
/// @param style 触感反馈类型
/// @param intensity 触感反馈强度 [0.0, 1.0]
+ (void)generateImpactFeedbackWithStyle:(UIImpactFeedbackStyle)style intensity:(CGFloat)intensity;

/// 产生触感反馈效果
/// @param style 触感反馈类型
+ (void)generateImpactFeedbackWithStyle:(UIImpactFeedbackStyle)style;

/// 产生触感反馈效果
+ (void)generateImpactFeedback;


// MARK: 播放声音

/// 使用系统声音服务播放系统声音
///
/// Apple官方公布的系统铃声列表: http://iphonedevwiki.net/index.php/AudioServices
///
/// @param soundID 声音ID, UInt32类型
+ (void)playSystemSoundWithSoundID:(SystemSoundID)soundID;

/// 使用系统声音服务播放指定的声音文件
/// @param name 声音文件名称
/// @param type 声音文件类型
+ (void)playSoundWithName:(NSString *)name type:(NSString *)type;

@end

NS_ASSUME_NONNULL_END

3.2 FeedbackGeneratorUtil.m

//
//  FeedbackGeneratorUtil.m
//
//  Created by wangzhi on 2022/7/15.
//

#import "FeedbackGeneratorUtil.h"

@implementation FeedbackGeneratorUtil

// MARK: 触感反馈

/// 产生触感反馈效果
///
/// 1. iOS 13.0之前, 无强度参数 intensity
///
/// 2. iOS 13.0之后, 增加强度参数 intensity , 即可以指定触感反馈强度
///
///  - intensity 设置为0.0时, 无触感反馈
///
///  - intensity 设置为1.0时, 其强度等价于 iOS 13.0之前的无intensity时的强度
///
/// @param style 触感反馈类型
/// @param intensity 触感反馈强度 [0.0, 1.0]
+ (void)generateImpactFeedbackWithStyle:(UIImpactFeedbackStyle)style intensity:(CGFloat)intensity {
    if (@available(iOS 10.0, *)) {
        UIImpactFeedbackGenerator *feedbackGenerator = [[UIImpactFeedbackGenerator alloc] initWithStyle:style];
        [feedbackGenerator prepare];
        
        if (@available(iOS 13.0, *)) {
            [feedbackGenerator impactOccurredWithIntensity:intensity];
        } else {
            [feedbackGenerator impactOccurred];
        }
    }
}

/// 产生触感反馈效果
/// @param style 触感反馈类型
+ (void)generateImpactFeedbackWithStyle:(UIImpactFeedbackStyle)style {
    [self generateImpactFeedbackWithStyle:style intensity:1.0];
}

/// 产生触感反馈效果
+ (void)generateImpactFeedback {
    [self generateImpactFeedbackWithStyle:UIImpactFeedbackStyleMedium];
}


// MARK: 播放声音

/// 使用系统声音服务播放系统声音
///
/// Apple官方公布的系统铃声列表: http://iphonedevwiki.net/index.php/AudioServices
///
/// .mp3 转 .caf 的终端命令:  afconvert mp3文件路径 目标caf文件路径 -d ima4 -f caff -v
/// 例如: afconvert /Users/xxx/Desktop/demo.mp3 /Users/xxx/Desktop/demo.caf -d ima4 -f caff -v
///
/// 由于自定义通知声音还是由 iOS 系统来播放的,所以对音频数据格式有限制,可以是如下四种之一:
/// Linear PCM       MA4 (IMA/ADPCM)       µLaw        aLaw
/// 对应音频文件格式是 aiff,wav,caf 文件,文件也必须放到 app 的 mainBundle 目录中。
///
/// 自定义通知声音的播放时间必须在 30s 内,如果超过这个限制,则将用系统默认通知声音替代。
///
/// @param soundID 声音ID, UInt32类型
+ (void)playSystemSoundWithSoundID:(SystemSoundID)soundID {
    // The system sound ID in the range 1000 to 2000
    if (soundID < 1000 || soundID > 2000) {
        NSLog(@"The system soundID in the range 1000 to 2000");
        soundID = 1000;
    }

    // 通过音效ID播放声音
    if (@available(iOS 9.0, *)) {
        AudioServicesPlaySystemSoundWithCompletion(soundID, ^{
        });
        
        // 震动
//        AudioServicesPlaySystemSoundWithCompletion(kSystemSoundID_Vibrate, ^{
//        });
        // 通过音效ID播放声音并带有震动
//        AudioServicesPlayAlertSoundWithCompletion(soundID, ^{
//        });
    } else {
        AudioServicesPlaySystemSound(soundID);
    }
}

/// 使用系统声音服务播放指定的声音文件
/// @param name 声音文件名称
/// @param type 声音文件类型
+ (void)playSoundWithName:(NSString *)name type:(NSString *)type {
    if (name.length == 0) {
        return;
    }
    
    // 1. 获取声音文件的路径
    NSString *soundFilePath = [[NSBundle mainBundle] pathForResource:name ofType:type];
    if (soundFilePath.length == 0) {
        return;
    }
    // 将地址字符串转换成url
    NSURL *soundFileURL = [NSURL fileURLWithPath:soundFilePath isDirectory:NO];
    
    // 2. 生成系统音效ID
    SystemSoundID soundID;
    AudioServicesCreateSystemSoundID((__bridge CFURLRef)soundFileURL, &soundID);

    // 3. 通过音效ID播放声音
    if (@available(iOS 9.0, *)) {
        AudioServicesPlaySystemSoundWithCompletion(soundID, ^{
        });
        
        // 震动
//        AudioServicesPlaySystemSoundWithCompletion(kSystemSoundID_Vibrate, ^{
//        });
        // 通过音效ID播放声音并带有震动
//        AudioServicesPlayAlertSoundWithCompletion(soundID, ^{
//        });
    } else {
        AudioServicesPlaySystemSound(soundID);
    }
}

@end
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容