<commit_before>[TOC]

# 1、简介 [![](http://appcan-download.oss-cn-beijing.aliyuncs.com/%E5%85%AC%E6%B5%8B%2Fgf.png)]()

友盟插件

## 1.1、说明
封装了友盟sdk的相关功能，事件的发送

## 1.2、开源源码
[点击](http://plugin.appcan.cn/details.html?id=286_index)至插件详情页（插件测试用例与插件包已经提供）

***

#2、 API预览

##2.1、 方法



> ### onEvent 发送事件

`uexUmeng.onEvent(eventName, jsonString);`

**说明**

* onEvent方法是向友盟平台发送自定义事件


**参数**

param为json字符串，包含的参数如下

| 参数名称 | 参数类型 | 是否必选 | 说明 | 默认值 |
| --- | --- | --- | --- | --- | --- |
| eventName | String | 是 | 事件的名称| 无 | 
| jsonString | String | 否| 事件的属性 | 无| 


**平台支持**

Android 2.2+ 
iOS 7.0+ 

**版本支持**

Android 3.0.0+ 
iOS 3.0.0+ 

**示例**

```
var eventName = "sell_event"
var data = {"item":"apple"}

var json = JSON.stringify(data);
uexUmeng.onEvent(eventName, json)

```

> ### getDeviceInfo 获取设备的基本信息

`uexUmeng.getDeviceInfo();`

**说明**
获取设备的基本信息，根据用户的需求，可以将某个设备指定为测试设备，测试设备所产生的数据不会污染真实数据。测试设备的配置在http://www.umeng.com/test_devices/new

相关 [cbGetDeviceInfo](#cbGetDeviceInfo 返回设备信息) 返回设备信息的回调方法

**参数**
无

**平台支持**

Android 2.2+ 
iOS 7.0+ 

**版本支持**

Android 3.0.0+ 
iOS 3.0.0+ 

**示例**

```
uexUmeng.getDeviceInfo();

```


##2.2、 回调方法

>### cbGetDeviceInfo 返回设备信息

`uexUmeng.cbGetDeviceInfo(param);`

**说明**

* 存储图片到相册后会调用此方法

**参数** 

param为json字符串，包含的参数如下

| 参数名称 | 参数类型 | 是否必选 | 说明 | 
| --- | --- | --- | --- | --- |
| param | String | 是 | 设备基本信息，格式如：Android格式:{"device_id": "your_device_id", "mac": "your_device_mac"} ;iOS格式:{"oid": "your_device_id"}|


**平台支持**

Android 2.2+ 
iOS 7.0+ 

**版本支持**

Android 3.0.0+ 
iOS 3.0.0+ 

**示例**

```
window.uexOnload=function(type){
  uexUmeng.cbGetDeviceInfo = function(info){
    alert(info);<commit_msg>Update uexUmeng.md<commit_after>[TOC]

# 1、简介 [![](http://appcan-download.oss-cn-beijing.aliyuncs.com/%E5%85%AC%E6%B5%8B%2Fgf.png)]()

友盟插件

## 1.1、说明
封装了友盟sdk的相关功能，事件的发送

## 1.2、开源源码
[点击](http://plugin.appcan.cn/details.html?id=286_index)至插件详情页（插件测试用例与插件包已经提供）

***

#2、 API预览

##2.1、 方法



> ### onEvent 发送事件

`uexUmeng.onEvent(eventName, jsonString);`

**说明**

* onEvent方法是向友盟平台发送自定义事件


**参数**

param为json字符串，包含的参数如下

| 参数名称 | 参数类型 | 是否必选 | 说明 | 默认值 |
| --- | --- | --- | --- | --- | --- |
| eventName | String | 是 | 事件的名称| 无 | 
| jsonString | String | 否| 事件的属性 | 无| 


**平台支持**

Android 2.2+ 
iOS 7.0+ 

**版本支持**

Android 3.0.0+ 
iOS 3.0.0+ 

**示例**

```
var eventName = "sell_event"
var data = {"item":"apple"}

var json = JSON.stringify(data);
uexUmeng.onEvent(eventName, json)

```

> ### getDeviceInfo 获取设备的基本信息

`uexUmeng.getDeviceInfo();`

**说明**
获取设备的基本信息，根据用户的需求，可以将某个设备指定为测试设备，测试设备所产生的数据不会污染真实数据。测试设备的配置在http://www.umeng.com/test_devices/new

相关 [cbGetDeviceInfo](#cbGetDeviceInfo 返回设备信息) 返回设备信息的回调方法

**参数**
无

**平台支持**

Android 2.2+ 
iOS 7.0+ 

**版本支持**

Android 3.0.0+ 
iOS 3.0.0+ 

**示例**

```
uexUmeng.getDeviceInfo();

```


##2.2、 回调方法

>### cbGetDeviceInfo 返回设备信息

`uexUmeng.cbGetDeviceInfo(param);`

**说明**

* 获取设备基本信息的回调

**参数** 

param为json字符串，包含的参数如下

| 参数名称 | 参数类型 | 是否必选 | 说明 | 
| --- | --- | --- | --- | --- |
| param | String | 是 | 设备基本信息，格式如：Android格式:{"device_id": "your_device_id", "mac": "your_device_mac"} ;iOS格式:{"oid": "your_device_id"}|


**平台支持**

Android 2.2+ 
iOS 7.0+ 

**版本支持**

Android 3.0.0+ 
iOS 3.0.0+ 

**示例**

```
window.uexOnload=function(type){
  uexUmeng.cbGetDeviceInfo = function(info){
    alert(info);
{'fraction_non_alphanumeric': 0.2195048309178744, 'fraction_numerical': 0.030193236714975844, 'mean_word_length': 3.780663780663781, 'pattern_counts': {'":': 8, '<': 3, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5088556', 'n_tokens_mistral': 2002, 'n_tokens_neox': 2048, 'n_words': 234}