基于无障碍服务实现微信多图分享。
- 分享多图+文字给好友。
- 分享多图+文字到朋友圈。
- 可自定义引导用户打开无障碍服务的弹窗。
- 朋友圈自动选图完成后可自动发布。
添加 jitpack
仓库到项目的 build.gradle
文件中
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
添加 WXShareMultiImage
依赖到应用的 build.gradle
文件中
implementation 'com.github.shichaohui:WXShareMultiImage:v2.0.1'
在 strings.xml 中自定义无障碍服务标签。
<string name="wx_share_multi_image_service_label">ShareDemo【多图分享】</string>
由于 SDK 涉及文件操作,请添加相关权限。
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
// 仅分享图片
WXShareMultiImageHelper.shareToSession(activity, bitmapList)
// 分享图片和文字
WXShareMultiImageHelper.shareToSession(activity, bitmapList, text)
// 仅分享图片
WXShareMultiImageHelper.shareToTimeline(activity, bitmapList)
// 分享图片和文字,并设置本次分享是否自动发布
val options = WXShareMultiImageHelper.Options().apply {
text = "待分享文案"
isAutoFill = true
isAutoPost = false
needShowLoading = true
onPrepareOpenWXListener = {
// do something
}
}
WXShareMultiImageHelper.shareToTimeline(activity, bitmapList, options)
WXShareMultiImageHelper.Options()
是分享可选配置。
text
:待分享文案,默认空字符串 "" 。isAutoFill
:是否自动填充文案和图片,默认 true 。- true:自动填充文案和图片。尝试使用无障碍服务,若无障碍服务未打开,会弹窗引导用户打开服务。
- false:手动填充文案和图片。
isAutoPost
:填充文案和图片后是否自动发布,默认 false。该属性仅在isAutoFill
为 true 时有效。- true:自动发布。
- false:手动发布。
needShowLoading
:是否显示默认的加载进度对话框,默认 true 。onPrepareOpenWXListener
:本次分享即将打开微信时的回调。可以在此处关闭自定义的加载进度对话框。
分享时会产生临时文件,每次分享前都会自动清理临时文件夹,也可以自行调用 API 清理。
WXShareMultiImageHelper.clearTmpFile(activity)
if(WXShareMultiImageHelper.isServiceEnabled(activity)) {
// do something.
} else {
// do something.
}
// Kotlin
WXShareMultiImageHelper.openService(activity) {
// 结果回调,it: Boolean 表示是否打开了无障碍服务。
isServiceEnabled = it
}
// Java
WXShareMultiImageHelper.openService(activity, new ServiceManager.OnOpenServiceListener() {
@Override
public void onResult(boolean isOpen) {
// do something.
}
});
if (WXShareMultiImageHelper.isServiceEnabled(context)) {
// 服务可用,直接分享
WXShareMultiImageHelper.shareToTimeline(context, bitmapList)
return
}
// 服务不可用,先弹窗引导用户打开服务,再根据结果分享
AlertDialog.Builder(context)
.setCancelable(false)
.setTitle("开启多图分享")
.setMessage("到[设置->辅助功能->无障碍]开启多图分享至朋友圈功能。")
.setPositiveButton("开启") { dialog, _ ->
dialog.cancel()
// 跳转到服务开关页面
WXShareMultiImageHelper.openService(context) {
// 服务开关页面关闭,执行分享
val options = WXShareMultiImageHelper.Options()
options.isAutoFill = it
WXShareMultiImageHelper.shareToTimeline(context, bitmapList, options)
}
}
.setNegativeButton("取消") { dialog, _ ->
dialog.cancel()
// 用户取消操作,执行分享
val options = WXShareMultiImageHelper.Options()
options.isAutoFill = false
WXShareMultiImageHelper.shareToTimeline(context, bitmapList, options)
}
.show()
Copyright 2018 StoneHui
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.