更新记录

1.0.3（2024-05-30）

更新依赖库

1.0.2（2024-05-26）

Api错误消息请看interface.uts中的WifiRoamingApiErrorCode

1.0.1（2024-05-17）

公布源码

平台兼容性

uni-app

uni-app x

插件使用

注意事项

• 1.HBuilderX设置->插件配置->uts开发扩展ndroid中gradle版本（若配置过）不能高于7.6.1
• 2.项目根目录manifest.json-App常用其他配置-targetSdkVerson需配置为大于等于33（由于官方目前不支持配置compileSdkVersion，这里升高targetSdkVersion后，App需要适配高版本Sdk）
• 3.导入插件后，需自定义基座后再使用
• 4.HBuilderX版本4.02及以上时，需删除插件app-android目录AndroidManifest.xml文件中的package字段，或者直接删除AndroidManifest.xml文件
• 5.插件仅适配android uniapp项目，不支持iOS，还未在uniappx中测试

  <!--app-android AndroidManifest.xml文件 -->
  <?xml version="1.0" encoding="utf-8"?>
  <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
  package="com.ccxxcoder.uniapp.wifiroaming">
  </manifest>

亮点

• 1.自动处理Android Location权限（符合应用市场对隐私弹窗的样式要求），使用者无需处理权限
• 2.Wi-Fi漫游检测，能获取Wi-Fi名称、Wi-Fi信号强度、Wi-Fi平均协商速率、手机IP、网关IP、ping 网关延时

使用

导入

<template>
    <view class="content">
        <image class="logo" src="/static/logo.png"></image>
        <view class="text-area">
            <text class="title">{{title}}</text>
        </view>
        <view class="buttonWrap">
            <button class="buttonItem buttonItemTopMargin" type="primary" @click="startWifiRoamingData">
                Wi-Fi漫游
            </button>
            <button class="buttonItem buttonItemTopMargin" type="primary" @click="startGetPhoneIpByWifi">
                获取IP地址
            </button>
        </view>
    </view>
</template>

<script>
    import {
        wifiRoamingApi,
        getIpByWifiModuleApiSync
    } from "@/uni_modules/citycoder-wifiroaming";
    export default {
        onLoad() {

        },
        data() {
            return {
                title: 'Hello'
            }
        },
        methods: {
            startWifiRoamingData() {
                wifiRoamingApi({
                    config: {
                        needsWifiDetail: true,
                        taskTimeout: 1200
                    },
                    permissionStyle: {
                        dialogPosition: 2,
                    },
                    success: (data) => {
                        console.log("WifiRoaming success called, data is " +
                            JSON.stringify(data));
                    },
                    failure: (errCode, errMsg) => {
                        console.log("WifiRoaming failure called, errCode: " +
                            errCode + ", errMsg: " + errMsg);
                    },
                    complete: (res) => {
                        console.log("WifiRoaming complete. ")
                    }
                });
            },

            startGetPhoneIpByWifi() {
                let ip = getIpByWifiModuleApiSync();
                console.log("startGetPhoneIpByWifi ip is " + ip)
            }
        }
    }
</script>

Api介绍

• 1.WifiRoamingApi Wi-Fi漫游检测
• 2.GetIpByWifiModuleApiSync 获取手机连接Wi-Fi时，手机的IP地址

Api参数

• 1.config Wi-Fi漫游检测配置，可配置是否获取Wi-Fi名称（涉及位置权限）
• 2.permissionStyle 配置权限对话框样式

个人博客

CSDN

DCloud个人中心