IMessage扩展简介
iOS10新加入的基于iMessage的应用扩展,可以丰富发送消息的内容。(分享表情、图片、文字、视频、动态消息;一起完成任务或游戏。)
简单的将发送的数据内型分为三种:
1.贴纸Stickers;
2.交互消息Interactive Messages; (本文介绍此种)
3.图片,音视频,文本,链接等;
两种显示模式:Compact和Expanded。
Compact(收缩)模式不能访问键盘和相机,不能使用横向滑动,横向滑动操作会由系统捕获;但可以访问输入框。
Expanded(展开)模式不能访问用户输入框;但是可以访问键盘、相机,并且可以使用横向滑动操作。
新建IMessage扩展
xcode新建
打开xcode :File->New->Target 然后在右侧输入框输入IMessage->点击IMessage Extension
podfile
podfile里面加入IMessage需要依赖的库,下面是一个例子,这里我提取了跟主应用公共依赖的库到函数commonPod,需要注意的是有用了UIAPPlication的库在IMessage里面可能导致崩溃,因为很多直接获取这个函数的都会返回空(因为是扩展)
platform :ios, '14.0'
def commonPod
pod "YYKit"
pod 'SnapKit'
pod 'SwiftyJSON'
end
target 'TestIM' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
commonPod
pod 'LookinServer', :configurations => ['Debug']
pod 'IQKeyboardManagerSwift'
end
target 'MyIM' do
use_frameworks!
commonPod
end
应用图标
新建项目默认在asset中有这个文件(如下图),但是右侧图标都是空的,需要按照下面图标标的样式,手动将对应文件拖到右边的那个位置。
目录结构
新建的IMessage扩展只有如下文件,主要UI代码是在MessagesViewController上进行显示。
使用IMessage api
MessagesViewController
本类为新建IMessage xcode自动为我们创建的类,他继承MSMessagesAppViewController(然后这个又继承自UIViewController),为主要控制IMessage展示的控制器。
它是如下图所示,框中的部分是收缩状态的vc,需要注意的是 他有一部分是在屏幕之外的,向上手动拖拽扩展的时候下面那块才会露出来。
这个是展开状态的vc:
主要生命周期:
//扩展激活(打开)前
open func willBecomeActive(with conversation: MSConversation)
//扩展已被激活(打开)
open func didBecomeActive(with conversation: MSConversation)
//扩展被关闭前
open func willResignActive(with conversation: MSConversation)
//扩展被关闭
open func didResignActive(with conversation: MSConversation)
//vc将要收起或者展开 初始化的时候不会调用,只在状态切换时调用。在松手的时候会调用
@available(iOS 10.0, *)
open func willTransition(to presentationStyle: MSMessagesAppPresentationStyle)
//vc完成收起或者展开 初始化的时候不会调用,只在状态切换时调用。
@available(iOS 10.0, *)
open func didTransition(to presentationStyle: MSMessagesAppPresentationStyle)
需要注意的是,只要这个ViewController变成不可见,这个扩展就会关闭(例如切换IMessage的其他扩展、切后台等。
MessagesViewController有展开收起状态,对应的,他的属性presentationStyle,会是expanded或者compact
open var presentationStyle: MSMessagesAppPresentationStyle { get }
手动调整扩展展开或收缩的状态切换
if isExpand {
requestPresentationStyle(.expanded)
}else{
requestPresentationStyle(.compact)
}
MSConversation
在MessagesViewController中有个属性叫activeConversation,它是MSConversation
,用来操作发送,例如IMessage的输入框里面插入文本或组件,或者直接在IMessage中发送文本或者组件。这个东西在模拟器上用回崩溃。
向IMessage的输入框插入文本(并换行)
activeConversation?.insertText("这是一串文本")
向IMessage的输入框插入组件:这里使用了MSMessageTemplateLayout配置样式,并通过发送MSMessage实现
let layout = MSMessageTemplateLayout()
layout.image = UIImage(named: "iMessage App Icon")
layout.caption = "Ask Al Anything"
let myMessage = MSMessage()
myMessage.layout = layout
activeConversation?.insert(myMessage)
这个组件可以发送到对方手机的IMessage,如果对方装了我们的应用,会在IMessage直接打开扩展并切换到展开状态,否则IMessage的appstore扩展会打开,并展示我们的应用详情页面。
坑点要点
见这篇文章:
iMessage 开发要点 坑点记录