iMessage App(MSMessagesAppViewController)

iMessage App

iMessage app 是iOS 10中嵌入到Message内容的iMessage apps,包含简单的表情包以及自定义的复杂界面。

iMessage App 简介

iMessage App是一种全新的应用扩展,载体是iOS系统的Message应用,通过iMessage App,用户可以发送更加丰富的消息内容,享受更具交互性的会话体验。

iMessage App本身是一个Extension,但是它可以独立开发,不依赖任何Container App。我们也可以在现有的项目中添加iMessage App,系统会自动将其添加到Messages App Store。

iMessage App只能在iOS(10+)系统运行,iWatch和mac可以收到消息,但是不能解析。iWatch可以发送Stickers。

iMessage App 类别

Sticker pack app:单独的表情包应用,不需要编写任何代码,只需拖动图片即可,包括静态和动态表情。

iMessage app:单独的iMessage应用,要编写代码,可以发送表情包、文字、视频、音频。

Messages App Store

用来干什么的呢

显示iMessage App;

为未安装应用的用户提供安装途径(Inline App Attribution);

提供iap,Apple Pay和访问相机功能。

iMessage App只能在iOS(10+)系统运行,iWatch和mac可以收到消息,但是不能解析。iWatch可以发送Stickers。

iMessage App本身是一个Extension,但是它可以独立开发,不依赖任何Container App。我们也可以在现有的项目中添加iMessage App,系统会自动将其添加到Messages App Store。

创建iMessage App

在Xcode 8中,可以直接创建一个iMessages Application(File->New->Project->Application->iMessage Application)

在现有项目中添加iMessage App,可以通过添加Extension的方式添加(File->New->Target->Application Extension->iMessage Extension)

Messages API

MSMessagesAppViewController

MSMessagesAppViewController是iMessage APP的主界面,用来展消息扩展的内容。

MSConversation

MSConversation是指当前的会话,包含发出、接收的消息。

MSMessage

MSMessage是消息体,包含了两个部分: *MSSession用来描述消息如何发送 *MSMessageLayout用来描述消息如何展示

Presentation Style

MSMessagesAppViewController有两种展现方式:typedef NS_ENUM(NSUInteger, MSMessagesAppPresentationStyle) { MSMessagesAppPresentationStyleCompact, MSMessagesAppPresentationStyleExpanded } NS_ENUM_AVAILABLE_IOS(10_0);在Compact模式下,不能访问键盘和相机,同时也不能使用横向滑动操作(Compact模式下,横向操作会由系统捕获),但是可以访问用户输入框。

在Expanded模式下,我们不能访问用户输入框,但是可以访问键盘、相机,并且可以使用横向滑动操作。

Extension Lifecycle

iMessage APP的生命周期会映射到MSMessagesAppViewController中,唤起或者销毁都大致有三个过程。 * ####Becoming active 1.- (void)viewDidLoad;2.- (void)didBecomeActiveWithConversation:(MSConversation *)conversation;3.- (void)viewWillAppear:(BOOL)animated;* ####Resigning active 1.- (void)viewWillDisappear:(BOOL)animated;2.- (void)viewDidDisappear:(BOOL)animated;3.- (void)willResignActiveWithConversation:(MSConversation *)conversation;

在MSMessagesAppViewController被用户关闭或通过其它方式dismiss之后,会执行- (void)willResignActiveWithConversation:(MSConversation *)conversation;,之后系统随时可以终止Message Extension(一般情况下会立刻终止)。

Compose a Message

创建一条Message

MSMessage *message = [[MSMessage alloc] initWithSession:session];

message.URL = [NSURL URLWithString:@"https://www.ccint.com"];

message.layout = layout;

message.accessibilityLabel = @"合合信息";

message.summaryText = @"INTSIG";

message.shouldExpire = NO;

调用MSMessage的初始化方法-(instancetype)initWithSession:(MSSession *)session;进行初始化,其中的参数session可以传一个新的MSSession对象或者是当前conversation中用户选中的message的session。 message中的layout属性是一个MSMessageLayout对象,它负责对message进行布局。

布局layout

MSMessageTemplateLayout *layout = [[MSMessageTemplateLayout alloc] init];

layout.image = image;

layout.imageTitle = imageTitle;

layout.imageSubtitle = imageSubtitle;

layout.caption = caption;

layout.trailingCaption = trailingCaption;

layout.subcaption = subcaption;

layout.trailingSubcaption = trailingSubcaption;

layout的布局如上图所示,界面上显示的属性一共有7个,分别为image,imageTitle,imageSubtitle,caption,trailingCaption,subcation和trailingSubcaption。将其中的caption,trailingCaption,subcation和trailingSubcaption置为nil时,布局会变成上图右边的样式。

发送Message

[self.activeConversation insertMessage:message completionHandler:^(NSError * _Nullable error) {

}];

[self.activeConversation insertText:test completionHandler:^(NSError * _Nullable error) {

}];

[self.activeConversation insertSticker:sticker completionHandler:^(NSError * _Nullable error) {

}];

[self.activeConversation insertAttachment:attachment withAlternateFilename:fileName completionHandler:^(NSError * _Nullable error) {

}];

通过MSMessagesAppViewController自身的属性activeConversation的相关方法,可以进行四种类型message的发送,具体方法为: *- (void)insertMessage:(MSMessage *)message completionHandler:(nullable void (^)(NSError * _Nullable))completionHandler;*- (void)insertText:(NSString *)text completionHandler:(nullable void (^)(NSError * _Nullable))completionHandler;*- (void)insertSticker:(MSSticker *)sticker completionHandler:(nullable void (^)(NSError * _Nullable))completionHandler;*- (void)insertAttachment:(NSURL *)URL withAlternateFilename:(nullable NSString *)filename completionHandler:(nullable void (^)(NSError * _Nullable))completionHandler;

[TOC]

推荐阅读更多精彩内容