Unity3D 调用Android与IOS的剪贴板
Unity3D剪贴板
最近遇到一个需要调用Android与IOS设备本身剪贴板的需求,就是在Unity中,要将文本复制到设备本身的剪贴板中,然后在其他应用程序中都能粘贴。
最开始在网上查到的方式是使用Unity3D本身自带的TextEditor 类进行使用,使用方法如下:
TextEditor te = new TextEditor();
te.content = new GUIContent(yourText);
te.OnFocus();
te.Copy();
期初在电脑上测试时是可以用的,然而这种到了Android和IOS设备上却坑了……完全没反应T_T。在多方查找之下,终无结果,所以能想到的方法就是在Unity中使用C#调用Android和IOS自身的接口分别实现。
ClipboardManager cm =(ClipboardManager) context.getSystemService(Context.CLIPBOARD_SERVICE);
//复制到剪贴板
cm.setText(message);
//从剪贴板获取文本
string text = cm.getText();
针对Android和IOS双平台
博主在踩了众多的坑之后,终于将Android和IOS分别实现,于是通过这个剪贴板例子到这里来跟大家分享一下Unity3D调用Android和IOS的一些简单的方法。
Unity3D调用Android剪贴板
public class ClipboardTools {
public static ClipboardManager clipboard = null;
// 向剪贴板中添加文本
public void copyTextToClipboard(final Context activity, final String str) throws Exception {
clipboard = (ClipboardManager) activity.getSystemService(Activity.CLIPBOARD_SERVICE);
ClipData textCd = ClipData.newPlainText("data", str);
clipboard.setPrimaryClip(textCd);
}
// 从剪贴板中获取文本
public String getTextFromClipboard() {
if (clipboard != null && clipboard.hasPrimaryClip()
&& clipboard.getPrimaryClipDescription().hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN)) {
ClipData cdText = clipboard.getPrimaryClip();
ClipData.Item item = cdText.getItemAt(0);
return item.getText().toString();
}
return "null";
}
}
Android复制
首先,Android剪贴板的使用要通过从Activity中获取ClipboardManager 服务,然后才能进行使用。在这里我们先定义了一个静态的ClipboardManager 引用:
public static ClipboardManager clipboard = null;
原因是当Unity3D对Android类(ClipboardTools)的方法掉用完后,可能会被垃圾回收,所以将ClipboardManager 定义为静态才能通过getTextFromClipboard()方法获取先前存入剪贴板的文本。
对Android剪贴板类ClipboardManager 的使用是固定的用法。
Android粘贴
做好了复制,粘贴模块就比较简单了,固定的模式,博主在此处添加了一些 if 的逻辑判断,是对剪贴板中内容进行判断,如:是否为文本,是否有内容等……但要注意的是,若没有将ClipboardManager 设为静态,则在调用完复制方法时,ClipboardTools类可能会被垃圾回收,那么ClipboardManager 的引用会变为null,从新获取不太方便,所以博主就将其设为静态了。
Android剪贴板项目导入Unity3D
在Unity3D中调用Android的东西,首先要在Unity3D项目中创建好环境:
1. 在Untiy3D项目的Assets目录下创建Plugins目录。
2. 在Plugins目录下创建Android目录。
3. 在Android 目录下创建bin目录。
4. 在bin 目录下放置你编写的类的jar包。
前三步都是创建文件夹就没什么好说了,从第四步开始,这里所说的Jar包仅仅是你所写的那个类的jar包,并非整个Android项目的jar包,使用Eclipse编写的同学可以在???中将Is Library勾上,就可以直接在Android项目下的bin文件夹下找到打好的Jar包。
第五步所说的Unity3D的 classes.jar 包,在你的Unity3D安装目录下的Editor\Data\PlaybackEngines\androidplayer\development\bin 目录下,直接将其复制到你的Unity3D项目的bin 目录下即可。
注:有些朋友可能进行了第五步后会出现Unity报错,这时可以先不进行第五步看看能不能搞定,原因可能是因为配置问题,还待校验……
Unity3D调用Android类与方法
在Unity3D中对Android类与方法的调用方法代码如下:
#if UNITY_ANDROID
AndroidJavaObject androidObject = new AndroidJavaObject("com.test.ClipboardTools");
AndroidJavaObject activity = new AndroidJavaClass("com.unity3d.player.UnityPlayer").GetStatic<AndroidJavaObject>("currentActivity");
if (activity == null)
return ;
// 复制到剪贴板
androidObject.Call("copyTextToClipboard", activity, input);
// 从剪贴板中获取文本
String text =androidObject.Call<String>("getTextFromClipboard");
#endif
首先,或取出先前编写的Android类的实例对象:
AndroidJavaObject androidClass = androidClass = new AndroidJavaObject("com.test.ClipboardTools");
要注意的是,后面的字符串"com.test.ClipboardTools"是你Android项目的<类目录> + <类名>,这个不能写错,写错就无法或取出你要的Android类。
接着,是获取Android所需要的Activity对象,也就是Android 项目中 copyTextToClipboard 方法所需要的 Context 参数,由于我们的Android类没有继承于Activity 类,而对ClipboardManager 的使用又需要当前Android运行时主线程的Activity,所以博主采用的是从 Unity3D 中获取后传输过去。
最后是对ClipboardManager 类的 “复制”、“获取”两个方法的调用。
#if UNITY_ANDROID 和 #endif 代表的是在指定的平台才进行编译,如此处的 UNITY_ANDROID 代表期间的代码只在Android平台才进行编译,若是直接使用,则可能在IOS平台出现编译异常,因为IOS平台并没有AndroidJavaObject 这种类的库文件。
Unity3D调用IOS剪贴板
使用Unity3D调用IOS的剪贴板相对容易,但是需要在MAC上进行编写测试。
IOS对剪贴板的使用
对IOS平台的调用博主采用简洁的方式,让Unity3D调用C,再用C去调用IOS的方法。先附上两个文件的源码:
Clipboard.h 文件 :
@ interface Clipboard : NSObject
extern "C"
{
/* compare the namelist with system processes */
void _copyTextToClipboard(const char *textList);
}
@end
Clipboard.mm 文件 :
@implementation Clipboard
//将文本复制到IOS剪贴板
- (void)objc_copyTextToClipboard : (NSString*)text
{
UIPasteboard *pasteboard = [UIPasteboard generalPasteboard];
pasteboard.string = text;
}
@end
extern "C" {
static Clipboard *iosClipboard;
void _copyTextToClipboard(const char *textList)
{
NSString *text = [NSString stringWithUTF8String: textList] ;
if(iosClipboard == NULL)
{
iosClipboard = [[Clipboard alloc] init];
}
[iosClipboard objc_copyTextToClipboard: text];
}
}
.h文件和.mm文件需要放在Unity项目的Assets/Plugins/目录下的任意目录下。
与C相同,Object-C也是需要一个头文件负责定义,还有一个真正编写内容的文件,这个文件可以有两种后缀“.m"和”.mm",“.m"中只能编写Object-C代码,而”.mm"中可以编写C代码。
在Clipboard.h中,我们定义了一个C的方法,在Clipboard.mm中,我们实现了C的方法,并在其中调用了IOS的剪贴板功能。代码挺简单,就不进行一一解释了。
这里稍微发下牢骚:博主学习过数种编程语言,自信在学习一种新语言时不会写至少能看懂,然而Object-C的出现碾碎了博主的现实,尼玛,这方法定义到底是神马意思?简直反人类啊……
Unity3D对IOS类的调用
Unity3D对IOS的使用倒是比较简单,不过也需要进行环境配置:
1. 在Untiy3D项目的Assets目录下创建Plugins目录。
2. 在Plugins目录下创建IOS目录。
3. 在IOS 目录下放置".h"文件和".mm"文件。
然后是调用的C#源码:
using UnityEngine;
using System.Collections;
using System.Runtime.InteropServices;
public class ClipboardManager
{
#if UNITY_IPHONE
/* Interface to native implementation */
[DllImport ("__Internal")]
private static extern void _copyTextToClipboard(string text);
#endif
public static void CopyToClipboard( string input)
{
#if UNITY_ANDROID
// 对Android的调用
#elif UNITY_IPHONE
_copyTextToClipboard(input);
#endif
}
}
这是一个C#类,CopyToClipboard()方法是对剪贴板的应用,大家可以看到,在ClipboardManager类里面,定义了这种东西:
#if UNITY_IPHONE
/* Interface to native implementation */
[DllImport ("__Internal")]
private static extern void _copyTextToClipboard(string text);
#endif
这表示在IOS平台的编译上,会导入Objcet-C编写的IOS方法,这是固定的写法,大概了解即可,不要忘了导入库文件哦(using System.Runtime.InteropServices;)
在下面,就可以直接对IOS定义方法的调用了,不过博主还是推荐加上以下东西:
#if UNITY_ANDROID
#elif UNITY_IPHONE
#endif
以免在跨平台编译时出现问题。