metaio Cloud Plugin官方教程--IOS开发

如果您打算基于metaio Cloud Plugin模板来开发应用，您只需要修改频道ID和Application Identifier即可

如果您想将metaio Cloud Plugin整合到您自己的应用上，请参照下列步骤：

---

将函数库导入Xcode

metaio Cloud Plugin是捆绑在metaio SDK上的

首先，将metaioSDK导入工程中。您可以直接在Finder中找到metaioSDK.framework，然后将其拖拉到Xcode的文件总览中

然后，将AugmentedReality文件夹中的文件拖拉到Xcode工程中，（根据需要）选择Copy items into destination group’s folder

之后，Xcode会将Plugin内容展开，如下图所示：

---

调整编译设置

使用Obj-C++编译

metaio Cloud Plugin是静态Obj-C++函数库，因此，包括MetaioCloudPlugin头文件在内的任何文件都必须用Obj-C++编译

要做到这点，您可以把文件扩展名改为.mm，或在Xcode中设置合理的定义

• 连接器标签
  

由于Plugin在函数库中定义了一些Objective-C对象，请您为Other Linker Flags添加-ObjC

• 所需框架
  

如果Xcode工程中没有下列框架/函数库，您需要人工添加：

• libXML2.dylib, libz.dylib
• AVFoundation, CoreVideo, CoreFoundation, CoreGraphics, CoreLocation, CoreMotion, CoreMedia, MediaPlayer, CFNetwork, Security, AudioToolbox, SystemConfiguration, MobileCoreServices, OpenGLES, QuartzCore, MapKit
  

---

启动ARViewController的代码示例：

1. - (IBAction)onStartPushed:(id)sender
   
2. {
   
3.    // Create a new ARViewController. All channel details and properties are defined in that class.
   
4.     // see ARViewController.mm for the implementation
   
5.     ARViewController* metaioCloudPlugin = [[ARViewController alloc] init];
   
6. 
   
7.     // present the viewcontroller
   
8.     [self presentModalViewController:metaioCloudPlugin animated:YES];
   
9. 
   
10.     // release it, because it's retained as modalViewController
    
11.     [metaioCloudPlugin release];
    
12. }

复制代码

---

调整MetaioCloudPluginDelegate协议的参数

1. /**
   
2. * Provide the channel number that should be opened by the plugin
   
3. * In order to get your channel ID, please signup as a developer on http://www.junaio.com/developer
   
4. * and create your own junaio channel.
   
5. *
   
6. * If you want to use a location based channel, be sure to return 'YES' for (BOOL) shouldUseLocation,
   
7. * otherwise 'NO'.
   
8. */
   
9. - (NSInteger) getChannelID
   
10. {
    
11.     // TODO: fill in your channel ID here.
    
12.     return 124471;        // AREL Test
    
13. 
    
14.     // set locationAtStartup to YES, because we're loading a location based channel
    
15.     // that needs the location at the first request
    
16.     //m_useLocationAtStartup = YES;
    
17.     //return 4796;    // Wikipedia EN channel
    
18. }
    
19. 
    
20. 
    
21. 
    
22. /** Optional
    
23. *
    
24. * return YES if the application should activate location sensors at startup
    
25. * This will cause the application requesting permission at startup
    
26. * Return YES here if you are using a location based channel that needs location at startup
    
27. * Returning NO will cause the request to the server having no location
    
28. */
    
29. - (BOOL) shouldUseLocationAtStartup
    
30. {
    
31.     return m_useLocationAtStartup;
    
32. }
    
33. 
    
34. 
    
35. 
    
36. /** Optional
    
37. *
    
38. * return YES if the application should support location
    
39. * If you return NO here, your application will never access the location sensors.
    
40. * Most scan channels don't need a location, so NO can be returned here.
    
41. */
    
42. - (BOOL) shouldUseLocation
    
43. {
    
44.     return YES;
    
45. }
    
46. 
    
47. 
    
48. /** Optional
    
49. *
    
50. * return YES to cache downloaded files
    
51. * During the development phase it makes sense to return NO here,
    
52. * if the channel content changes a lot.
    
53. */
    
54. - (BOOL) shouldUseCache
    
55. {
    
56.     return YES;
    
57. }
    
58. 
    
59. 
    
60. /** Default implementation for Sharing a screenshot
    
61. *
    
62. * Feel free to adjust the source of ASImageSharingViewController to adjust its behavior or integrate the Facebook SDK
    
63. */
    
64. - (void) openSharingViewController: (UIImage*) imageToShare
    
65. {
    
66.     ASImageSharingViewController* controller = [[ASImageSharingViewController alloc] initWithNibName:@"ASImageSharingViewController" bundle:nil];
    
67.     controller.imageToPost = imageToShare;
    
68.     [self presentModalViewController:controller animated:YES];
    
69.     [controller release];
    
70. }

复制代码