Harmony-Free WeChat Open Platform (WeChat Official Account Platform)

Hello, dear students! Good morning! Today, we are going to talk about the third-party libraries of the WeChat Open Platform. I believe that many of you have encountered various problems during the development process. Today, I will help you all clear up the problems with the WeChat third-party platform SDK.

一、First, according to the requirements of the WeChat Open Platform, create the configuration for your own HarmonyOS application.

二、Secondly, when using the SDK of third-party platforms, we must first import the third-party libraries.

1、The method of introducing third-party libraries in WeChat

ohpm install @tencent/wechat_open_sdk

2、Check if WeChat is installed, and then add the following declaration in module.json5 "weixin""wxopensdk"

3、Configuration and the action agreed upon with WeChat: wxentity.action.open

三、Implement the related functions of WeChat

1、Initialization (requires WeChat app ID)

// WeChat ID 
private wxId: string = "wxXXXXXXXXXappid";
// Instantiate the WeChat object 
private wx: WXApi = WXAPIFactory.createWXAPI(this.wxId)
// Application Context
private context: common.UIAbilityContext = getContext() as common.UIAbilityContext;

2、WeChat message monitoring

// Initialization 
this.wx.handleWant(appWant, WXShareEventHandler)
// Register the Resp event WXShareEventHandler.registerOnWXRespCallback(handler.onResp)
// Cancel Resp event WXShareEventHandler.unregisterOnWXRespCallback(handler.onResp)
// Registration Request Event WXShareEventHandler.registerOnWXReqCallback(handler.onReq)
// Logout Req event
WXShareEventHandler.unregisterOnWXReqCallback(handler.onReq)

Add the listening code file

import { BaseReq, BaseResp, Log, WXApiEventHandler } from "@tencent/wechat_open_sdk"

const kTag = "SharePluginWXApiEventHandlerImpl"

export type OnWXReq = (req: BaseReq) => void

export type OnWXResp = (resp: BaseResp) => void

class WXApiEventHandlerImpl implements WXApiEventHandler {
  private onReqCallbacks: Map<OnWXReq, OnWXReq> = new Map
  private onRespCallbacks: Map<OnWXResp, OnWXResp> = new Map

  registerOnWXReqCallback(on: OnWXReq) {
    this.onReqCallbacks.set(on, on)
  }
  unregisterOnWXReqCallback(on: OnWXReq) {
    this.onReqCallbacks.delete(on)
  }

  registerOnWXRespCallback(on: OnWXResp) {
    this.onRespCallbacks.set(on, on)
  }
  unregisterOnWXRespCallback(on: OnWXResp) {
    this.onRespCallbacks.delete(on)
  }

  onReq(req: BaseReq): void {
    Log.i(kTag, "onReq:%s", JSON.stringify(req))
    this.onReqCallbacks.forEach((on) => {
      on(req)
    })
  }

  onResp(resp: BaseResp): void {
    Log.i(kTag, "onResp:%s", JSON.stringify(resp))
    this.onRespCallbacks.forEach((on) => {
      on(resp)
    })
  }
}
export const WXShareEventHandler = new WXApiEventHandlerImpl

3、WeChat Sharing

Key point: Package the shared fixed elements into the "shareType" method

Parameter 1: shareType - Sharing Type

0: SendMessageToWXReq.WXSceneSession (Friend)

SendMessageToWXReq.WXSceneTimeline (Friend Circle)

Parameter 2: object: Sharing object

textObject: Sharing Content Object

imageObject: Sharing Image Object

webpageObject: Webpage Sharing Object

miniProgramObject: Mini Program Sharing Object

shareType(shareType:number,object:WXMediaMessage,handler?:HandlerAction):SendReqResultWrap{
    let req = new SendMessageToWXReq()
    req.scene = shareType

    let mediaMessage = new WXMediaMessage()
    mediaMessage.mediaObject = object
    mediaMessage.title = message.title
    mediaMessage.description = message.description

    req.message = message

    this.wx.sendReq(this.context,req)
}

Copywriting Share

const textObject = new WXTextObject()
textObject.text = args
this.shareType(0,textObject)

Image sharing

const imageObject = new WXImageObject()
imageObject.uri = fileUri.getUriFromPath("file://path");
this.shareType(0,imageObject)

Webpage sharing

const webpageObject = new WXWebpageObject("https://xxxxxxx")
webpageObject.webpageUrl = args
this.shareType(0,webpageObject)

Mini-program sharing

const miniProgramObject = new WXMiniProgramObject()
miniProgramObject.userName = "username"
miniProgramObject.path = "path"
this.shareType(0,miniProgramObject)

4、Launch the WeChat mini-program from the app.

const req = new LaunchMiniProgramReq()
req.userName = "username"
req.path = "path"
this.wx.sendReq(this.context,req)

5、Tap to open WeChat

let ctx = getContext(this) as common.UIAbilityContext
let want:Want = {
    uri:"uri",
    action: "ohos.want.action.viewData"
}
ctx.startAbility(want);

Note: The complete code has been submitted to the HarmonyOS Third-Party Library. Please use the following command to install it.

ohpm install @free/wechat

Calling method

// Share Content
WeChat.install.shareText("text",{onResp:(resp)=>{}})
// Share the picture
WeChat.install.shareImage("https://xxx",{onResp:(resp)=>{}})
// Share the webpage
WeChat.install.shareWeb("https://xxx",{onResp:(resp)=>{}})
// Share Mini Program
WeChat.install.shareMini({username:"username",path:"path"},{onResp:(resp)=>{}})
// Open the WeChat mini-program
WeChat.install.openMini({username:"username",path:"path"},{onResp:(resp)=>{}})
// Open WeChat
WeChat.install.openWX("uri",{onResp:(resp)=>{}})

If you like this content, please give a little heart!