O2M 移动端原生能力 API 文档

## 一、通知类方法
### 1. alert(obj)
- **描述**：原生 Alert 提示弹出窗
- **参数**：
```javascript
{
title: "提示", // 消息标题（可选）
message: "消息内容", // 消息内容
buttonName: "确定", // 确定按钮名称
onSuccess: function, // 成功回调
onFail: function // 失败回调
}
```
- **示例**：
```javascript
o2m.notification.alert({
message: "亲爱的",
buttonName: "收到",
onSuccess: () => {}
});
```

### 2. confirm(obj)
- **描述**：原生 Confirm 提示弹出窗
- **参数**：
```javascript
{
title: "提示", // 消息标题（可选）
message: "消息内容",
buttonLabels: ["确定", "取消"], // 按钮名称数组
onSuccess: function(buttonIndex), // 回调参数：被点击按钮的索引（0 开始）
onFail: function
}
```

### 3. prompt(obj)
- **描述**：原生 Prompt 输入提示窗
- **参数**：
```javascript
{
title: "提示", // 消息标题（可选）
message: "消息内容",
buttonLabels: ["继续", "不玩了"],
onSuccess: function(result), // 回调参数：{ buttonIndex: 0, value: "输入值" }
onFail: function
}
```

### 4. toast(obj)
- **描述**：轻量级 Toast 提示
- **参数**：
```javascript
{
message: "提示信息",
onSuccess: function,
onFail: function
}
```

## 二、日期与时间选择
### 1. datePicker(obj)
- **描述**：日期选择器
- **参数**：
```javascript
{
value: "2023-10-01", // 默认显示日期
onSuccess: function(result), // 回调参数：{ value: "选中日期" }
onFail: function
}
```

### 2. timePicker(obj)
- **描述**：时间选择器
- **参数**：
```javascript
{
value: "14:30", // 默认显示时间
onSuccess: function(result), // 回调参数：{ value: "选中时间" }
onFail: function
}
```

### 3. chooseInterval(obj)
- **描述**：日期区间选择器
- **参数**：
```javascript
{
startDate: "2023-10-01",
endDate: "2023-10-03",
onSuccess: function(result), // 回调参数：{ startDate: "开始日期", endDate: "结束日期" }
onFail: function
}
```

## 三、设备相关功能
### 1. scan(obj)
- **描述**：扫码功能
- **参数**：
```javascript
{
onSuccess: function(result), // 回调参数：扫码结果字符串
onFail: function
}
```

### 2. location(obj)
- **描述**：单次定位功能
- **参数**：
```javascript
{
onSuccess: function(result), // 回调参数：{ latitude, longitude, address }
onFail: function
}
```

### 3. localAuth(obj)
- **描述**：生物识别认证
- **参数**：
```javascript
{
onSuccess: function(result), // 回调参数：{ value: Boolean }
onFail: function
}
```

## 四、导航与页面控制
### 1. close()
- **描述**：关闭当前原生页面
- **示例**：
```javascript
o2m.util.navigation.close();
```

### 2. openInnerApp(obj)
- **描述**：打开内部应用（如待办、考勤等）
- **参数**：
```javascript
{
appKey: "attendance", // 应用标识
portalFlag: "门户标识", // 门户专用参数
portalTitle: "门户标题",
portalPage: "页面 ID",
onSuccess: function,
onFail: function
}
```

### 3. openWindow(obj)
- **描述**：新窗口打开网页
- **参数**：
```javascript
{
url: "https://www.o2oa.net",
onSuccess: function,
onFail: function
}
```

## 五、通讯录选择器
### 1. PersonPicker(obj)
- **描述**：人员选择器
- **参数**：
```javascript
{
multiple: true, // 是否多选
maxNumber: 0, // 最大选择数
pickedUsers: [], // 已选人员 DN 列表
onSuccess: function(result), // 回调参数：{ users: Array<Person> }
onFail: function
}
```

### 2. ComplexPicker(obj)
- **描述**：复合选择器（支持部门、身份、群组、人员）
- **参数**：
```javascript
{
pickMode: ["departmentPicker", "identityPicker"], // 选择器类型
multiple: true,
onSuccess: function(result), // 回调参数包含所有选中类型的数据
onFail: function
}
```

## 六、其他实用方法
### 1. setTitle(obj)
- **描述**：设置页面标题
- **参数**：
```javascript
{
title: "新标题",
onSuccess: function,
onFail: function
}
```

### 2. vibrate(obj)
- **描述**：手机震动
- **参数**：
```javascript
{
duration: 300, // 震动时长（Android 有效）
onSuccess: function,
onFail: function
}
```

## 注意事项
1. **使用范围**：仅在 O2OA 移动端 APP 中生效
2. **回调处理**：所有异步方法需通过 `onSuccess`/`onFail` 处理结果
3. **权限要求**：部分功能（如定位、扫码）需确保已获取对应权限