提交 4a31b6b6 编写于 作者: 杜庆泉's avatar 杜庆泉

wifi 新增ts-doc 描述

上级 e9cd4eeb
...@@ -5,6 +5,13 @@ ...@@ -5,6 +5,13 @@
"style": { "style": {
"navigationBarTitleText": "uni-app" "navigationBarTitleText": "uni-app"
} }
},
{
"path": "pages/autotest/uni-getbatteryinfo/uni-getbatteryinfo",
"style": {
"navigationBarTitleText": "uni-getbatteryinfo",
"enablePullDownRefresh": false
}
} }
], ],
"globalStyle": { "globalStyle": {
......
/** /**
* Wifi 函数通用入参封装 * Wifi 函数通用入参封装
*/ */
export type WifiOption = { export type WifiOption = {
success?: (res: UniWifiResult) => void; success ?: (res : UniWifiResult) => void;
fail?: (res: UniWifiResult) => void; fail ?: (res : UniWifiResult) => void;
complete?: (res: UniWifiResult) => void; complete ?: (res : UniWifiResult) => void;
}; };
/** /**
* Wifi 链接参数封装 * Wifi 链接参数封装
*/ */
export type WifiConnectOption = { export type WifiConnectOption = {
SSID?: string; SSID ?: string;
BSSID?: string; BSSID ?: string;
password?: string; password ?: string;
maunal?: boolean; maunal ?: boolean;
partialInfo?: boolean; //ios不生效 partialInfo ?: boolean; //ios不生效
success?: (res: UniWifiResult) => void; success ?: (res : UniWifiResult) => void;
fail?: (res: UniWifiResult) => void; fail ?: (res : UniWifiResult) => void;
complete?: (res: UniWifiResult) => void; complete ?: (res : UniWifiResult) => void;
} }
/** /**
* 获取当前链接的wifi信息 * 获取当前链接的wifi信息
*/ */
export type GetConnectedWifiOptions = { export type GetConnectedWifiOptions = {
partialInfo?: boolean partialInfo ?: boolean
success?: (res: UniWifiResult) => void success ?: (res : UniWifiResult) => void
fail?: (res: UniWifiResult) => void fail ?: (res : UniWifiResult) => void
complete?: (res: UniWifiResult) => void complete ?: (res : UniWifiResult) => void
} }
/* /*
* 对外暴露的wifi信息 * 对外暴露的wifi信息
*/ */
export type UniWifiInfo = { export type UniWifiInfo = {
SSID: string; SSID : string;
BSSID?: string; BSSID ?: string;
secure?: boolean; secure ?: boolean;
signalStrength?: number; signalStrength ?: number;
frequency?: number; frequency ?: number;
} }
...@@ -47,35 +47,35 @@ export type UniWifiResult = { ...@@ -47,35 +47,35 @@ export type UniWifiResult = {
errCode : number, errCode : number,
errSubject : string, errSubject : string,
errMsg : string, errMsg : string,
wifi: UniWifiInfo | null wifi : UniWifiInfo | null
} }
export type UniWifiCallback = () => void export type UniWifiCallback = () => void
export type StartWifi = (option: WifiOption) => void export type StartWifi = (option : WifiOption) => void
export type StopWifi = (option: WifiOption) => void export type StopWifi = (option : WifiOption) => void
export type GetWifiList = (option: WifiOption) => void export type GetWifiList = (option : WifiOption) => void
export type OnGetWifiList = (callback: UniWifiCallback) => void export type OnGetWifiList = (callback : UniWifiCallback) => void
export type OffGetWifiList = (callback: UniWifiCallback) => void export type OffGetWifiList = (callback : UniWifiCallback) => void
export type GetConnectedWifi = (option: GetConnectedWifiOptions) => void export type GetConnectedWifi = (option : GetConnectedWifiOptions) => void
export type ConnectWifi = (option: WifiConnectOption) => void export type ConnectWifi = (option : WifiConnectOption) => void
export type OnWifiConnected = (callback: UniWifiCallback) => void export type OnWifiConnected = (callback : UniWifiCallback) => void
export type OnWifiConnectedWithPartialInfo = (callback: UniWifiCallback) => void export type OnWifiConnectedWithPartialInfo = (callback : UniWifiCallback) => void
export type OffWifiConnected = (callback: UniWifiCallback | null) => void export type OffWifiConnected = (callback : UniWifiCallback | null) => void
export type OnOffWifiConnectedWithPartialInfo = (callback: UniWifiCallback | null) => void export type OnOffWifiConnectedWithPartialInfo = (callback : UniWifiCallback | null) => void
export type SetWifiList = (option: WifiOption) => void export type SetWifiList = (option : WifiOption) => void
interface Uni { interface Uni {
/** /**
...@@ -84,11 +84,18 @@ interface Uni { ...@@ -84,11 +84,18 @@ interface Uni {
* @param {WifiOption} option * @param {WifiOption} option
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#startwifi * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#startwifi
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -100,11 +107,18 @@ interface Uni { ...@@ -100,11 +107,18 @@ interface Uni {
* @param {WifiOption} option * @param {WifiOption} option
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#stopwifi * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#stopwifi
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -114,11 +128,18 @@ interface Uni { ...@@ -114,11 +128,18 @@ interface Uni {
* @param {WifiConnectOption} option * @param {WifiConnectOption} option
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#connectWifi * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#connectWifi
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -135,24 +156,31 @@ interface Uni { ...@@ -135,24 +156,31 @@ interface Uni {
password:"streamApp!2016", password:"streamApp!2016",
}], }],
output:{ output:{
callbackType: 'success', callbackType: 'success',
value: { errCode: 12013 ,errMsg: "connectWifi:wifi config may be expired",errSubject: "uni-connectWifi"} value: { errCode: 12013 ,errMsg: "connectWifi:wifi config may be expired",errSubject: "uni-connectWifi"}
} }
} }
] ]
} }
*/ */
connectWifi: ConnectWifi, connectWifi : ConnectWifi,
/** /**
* 请求获取 Wi-Fi 列表。wifiList 数据会在 onGetWifiList 注册的回调中返回。 * 请求获取 Wi-Fi 列表。wifiList 数据会在 onGetWifiList 注册的回调中返回。
* @param {WifiOption} option * @param {WifiOption} option
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#getWifiList * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#getWifiList
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -173,11 +201,18 @@ interface Uni { ...@@ -173,11 +201,18 @@ interface Uni {
* @param {UniWifiCallback} callback * @param {UniWifiCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onGetWifiList * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onGetWifiList
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -189,11 +224,18 @@ interface Uni { ...@@ -189,11 +224,18 @@ interface Uni {
* @param {UniWifiCallback} callback * @param {UniWifiCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#offGetWifiList * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#offGetWifiList
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -205,11 +247,18 @@ interface Uni { ...@@ -205,11 +247,18 @@ interface Uni {
* @param {GetConnectedWifiOptions} option * @param {GetConnectedWifiOptions} option
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#getConnectedWifi * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#getConnectedWifi
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -221,11 +270,18 @@ interface Uni { ...@@ -221,11 +270,18 @@ interface Uni {
* @param {UniWifiCallback} callback * @param {UniWifiCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onWifiConnected * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onWifiConnected
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -237,11 +293,18 @@ interface Uni { ...@@ -237,11 +293,18 @@ interface Uni {
* @param {UniWifiCallback} callback * @param {UniWifiCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onWifiConnectedWithPartialInfo * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onWifiConnectedWithPartialInfo
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -253,11 +316,18 @@ interface Uni { ...@@ -253,11 +316,18 @@ interface Uni {
* @param {UniWifiCallback} callback * @param {UniWifiCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#offWifiConnected * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#offWifiConnected
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
...@@ -269,15 +339,22 @@ interface Uni { ...@@ -269,15 +339,22 @@ interface Uni {
* @param {UniWifiCallback} callback * @param {UniWifiCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onOffWifiConnectedWithPartialInfo * @tutorial https://uniapp.dcloud.net.cn/api/system/wifi.html#onOffWifiConnectedWithPartialInfo
* @uniPlatform { * @uniPlatform {
* app: { * app: {
* android: "4.4.4", * "android": {
* ios: "9.0", * "osVer": "4.4.4",
* page: ['vue','uvue','nvue'] * "uniVer": "3.7.0",
* } * "unixVer": "3.9.0"
* },
* "ios": {
* "osVer": "9.0",
* "uniVer": "3.7.7",
* "unixVer": "3.9.0"
* }
* }
* } * }
* @uniVersion 3.7.7 * @uniVersion 3.7.7
* @uniVueVersion 2,3 //支持的vue版本 * @uniVueVersion 2,3 //支持的vue版本
*/ */
onOffWifiConnectedWithPartialInfo : OnOffWifiConnectedWithPartialInfo, onOffWifiConnectedWithPartialInfo : OnOffWifiConnectedWithPartialInfo,
setWifiList : SetWifiList, setWifiList : SetWifiList,
} }
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册