类 WKInterfaceImage

能够在watchOS应用的界面中显示图片的控件.

声明

@interface WKInterfaceImage:WKInterfaceObject

概述

在watchOS应用中显示的图片可以是静态或者动态的.使用WKInterfaceImage对象来指定你要显示的图片数据,并控制图片的动画.
不要自己子类化或者创建该类的实例.你应该这样做,在创建的界面控制器的类中定义输出口,然后将之和故事板文件中的相应对象连接起来.比如,为了在界面中引用一个图片对象,你先在你的界面控制器中用以下语法定义一个属性:

@property (weak, nonatomic) IBOutlet WKInterfaceImage* myImage;

在你的界面控制器初始化的时候,WatchKit会创建所有需要的图片对象,然后将他们分配给他们关联的输出口.这个时候,你可以使用那些对象对界面上的图像进行更改.
你在界面上使用的图片可能是在手表应用的包内的,可能是动态创建的,或者是总网络上下载的.手表应用包内的图片,表示这些图片是你的应用的用户界面的一部分,和应用文件存放在一起.下载或者动态创建的图片,存放于内存中或者以文件的形式存放于WatckKit扩展的容器目录内.WKInterfaceImage类提供了好几种设置方法,来让你的图片显示到屏幕上,不管他们存放于什么位置.

图片管理

你在界面上使用的图片可能存放于不同的地方,那么你加载和管理这些图片就有不同的方法:

• 存储位于Watch应用包中,是标准界面的一部分的图片.使用资源目录来存储图片,并按照需要适配的设备提供不同的尺寸.使用setImageNamed:方法来展示位于资源目录或者Watch应用
  包中的图片.

  可以在手表应用包中存储动画的图片序列,但是图片文件必须遵循指定的命名规则.这些规则的具体信息,请参考章节播放图片序列.

• 存储从网络下载下来的,位于应用扩展容器目录. 图片文件必须本地存储于应用扩展容器目录(WatchKit extension’s container directory)内,并且在运行时将图片数据加载到内存.如果要展示一个图片,而不需要额外进行修改,可以加载图片原始数据到NSData对象,然后用'setImageData:'方法来在界面上展示该图片.原始图像数据,一般都是经过压缩的,传输起来会比UIImage对象块.

• 直接设置动态创建的图片.如果使用编程方式绘制的图片内容,最终创建一个UIImage对象,并用setImage:方法来显示.也可以使用该技术来显示用animatedImageNamed:duration:或者animatedImageWithImages:duration:方法动态创建的动画的图片序列.

创建图像时，请始终以适合基础设备的大小创建图像。尽可能使用相同大小的图像，而不考虑底层设备。如果您需要不同设备大小的不同图像，请使用资产目录使用相同的图像名称存储不同版本的图像。如果指定的图像太大或太小，WatchKit将使用在Interface Builder中设置的mode属性来确定如何渲染图像。

支持的图片格式

你可以使用任何iOS支持的图片格式,但是还是建议尽可能的使用JPEG和PNG格式的图片.
使用JPEG或者PNG之外的图片,在渲染图片的时候可能会影响性能.所有图片应该是用于视网膜屏的,一个名为filename的图片,都应该有一个filename@2x的图片对应.

更多关于支持的图片格式的信息,请参考UIImage.

播放图片序列

使用动态图像,是让你界面更生动,更吸引用户的简单而有效的方法.你可以使用两种方式来显示动态图像:

• 资源目录中的图片;
• 根据你想要显示的图片序列创建的UIImage对象.

要根据根据资源目录中的图片来显示动态图像,你需要将照以下约定来命名图片资源:<name><number>,<name>是这一个图片序列中都一样的,<number>表示该图片在该序列中的序号.一个图片序列中的第一张图片的序号应该是0或者1.比如,一个动态图像包含3个图片,他们的名字可以是:image1,image2,image3.如果你没有把图片文件放在手表应用包的资源目录中,图片序列的命名规则是一样的,但是他们需要有同样的文件扩展名,比如:image1.jpg,image2.jpg,image3.jpg.

尽可能将图片资源放在手表应用包(不是手表应用扩展包)的资源目录中.把图片放在手表应用包中,你可以使用setImageNamed:方法来在运行时加载动画图片,这样就简化了加载过程.对于动态生成的动画图片序列,使用UIImage的animatedImageWithImages:duration:方法来将手表应用扩展中的动画图片整合到一起,然后用setImage:方法来设置动画图片.

注意
你不能使用UIImage的animatedImageWithImages:duration:方法来从手表应用包中创建动画图片.该方法在活动进程的包（WatchKit extension’s bundle)中查找图像。若要从Watch app bundle中的图像加载动画图像序列，必须正确地命名图像资源并使用此类的setImageNamed:方法来显示。

要了解如何创建动画图像的更多信息,请参考UIImage中的animatedImageNamed:duration:and animatedImageWithImages:duration:方法.

Interface Builder配置选项

Xcode提供了在stroyboard文件中,配值WKInterfaceImage对象的方法.表1列举了可以配置的属性,以及这些属性所代表的意义.

Table 1 WKInterfaceImage可设置属性

属性名	描述
Image	要展示的图片的名称.该图片文件必须位于Watch app's bundle.如果不在故事版中设置图片,可以通过该类的一些方法在程序中设置.
Mode	图片内容显示模式.mode定义了图片如何填充整个用于显示的空间.一些模式可以让你缩放时保持或者不保持纵横比.其他的模式,让你可以相对于WKInterfaceImage对象的边界中的某些固定点对图片进行定位.
Tint	应用于模板图片的颜色.你可以在程序中使用setTintColor:方法来改变tint color.该属性对于动画图片和非模板图片来说没有效果.
Animate	表明该图片是否可以动画的布尔值.设置YES来配置动画参数,包括持续时间(秒),是否在父界面控制器显示在屏幕上时,就立即开始动画.在加载时就开始的动画会不断循环播放.

主题

配置图片

• - setImage:
  让WKInterfaceImage对象显示指定的图片对象.

• - setImageData:
  让WKInterfaceImage对象显示格式化的图片数据对象.

• - setImageNamed:
  让WKInterfaceImage对象显示指定名称的图片资源文件.

• - setTintColor:
  改变应用于模板图片的颜色.

关系

父类

WKInterfaceObject

协议

WKImageAnimatable

相关资料

图片和视频

• WKImage
  用于WKInterfacePicker的图片的封装

• WKImageAnimatable
  控制动画图片播放的方法的集合

• WKInterfaceMovie
  在手表应用中播放视频和音频内容的界面元素.

• WKInterfaceInlineMovie
  显示视频的海报图片并且支持在线播放视频的界面元素.

• WKInterfaceHMCamera
  显示连接到HomeKit的IP照相机的视频流或者图片信息的界面元素.

• WKVideoGravity
  指示视频内容显示效果的常量.

Preference

WKInterfaceImage-苹果官方文档