uniappはオフラインメッセージング機能をどのように実装していますか?-uni-app-php.cn

uniappはオフラインメッセージング機能をどのように実装していますか?

PHPz

リリース： 2023-04-18 14:48:39

オリジナル

2257 人が閲覧しました

モバイルインターネットの普及と発展に伴い、メッセージプッシュはモバイルアプリケーションの標準機能の 1 つになりました。実際のアプリケーションシナリオでは、デバイスがインターネットに接続できない場合に、重要なメッセージを見逃す可能性がある状況にユーザーが遭遇することがよくあります。この問題を解決するために、Jiguang Push は、プッシュメッセージを Jiguang サーバーに一時的に保存し、デバイスがインターネットに接続された後にユーザーに再度プッシュできるオフラインメッセージング機能を提供します。 uniapp アプリケーションでは、オフラインメッセージの実装も非常に簡単です。

1. Aurora プッシュ設定

まず、Aurora 公式 Web サイトで開発者アカウントを登録し、アプリケーションを作成する必要があります。次に、公式ドキュメントのガイドラインに従ってアプリケーションの基本設定 (アプリケーション名、パッケージ名、署名などの入力など) を完了し、Aurora Push SDK を uniapp アプリケーションに統合します。

2. オフラインメッセージの設定

Jiguang のオフラインメッセージ機能を使用するには、Jiguang の公式 Web サイトのコンソールでオフラインメッセージオプションを有効にする必要があります

次に、uniapp でapplication 次のコードを main.js ファイルに追加します。

import Vue from 'vue'
import App from './App'

// 引入uni推送插件
import { getRegistrationId } from '@/common/jpush.js'

Vue.config.productionTip = false

App.mpType = 'app'

const app = new Vue({
  ...App
})

// 获取极光注册id
getRegistrationId()

// 将app实例挂载在uni上
uni.$app = app

app.$mount()

ログイン後にコピー

このコードでは、最初に「jpush.js」という名前のファイルを導入します。これは手動で作成する必要があります。次に、「getRegistrationId」メソッドを通じてデバイスの Aurora 登録 ID を取得し、キャッシュします。このメソッドの実装については、次のセクションで説明します。

3. オフラインメッセージの取得

前のセクションでは、デバイスの Aurora 登録 ID の取得とキャッシュを実装する「jpush.js」という名前のファイルについて説明しました。このファイルのコードは次のとおりです:

// 引入uni-app插件包
import { jpush } from '@uni/plugins'

/**
 * 获取极光注册id
 */
export function getRegistrationId() {
  // 先尝试从缓存中获取
  let registrationId = uni.getStorageSync('jpushRegistrationId')
  if (registrationId) {
    return registrationId
  }
  // 调用极光推送插件获取注册id
  jpush.getRegistrationID({
    success(res) {
      console.log('获取jpush注册id成功', res)
      // 缓存注册id
      uni.setStorageSync('jpushRegistrationId', res.registrationId)
      // 将注册id发送到后台服务器
      sendRegistrationIdToServer(res.registrationId)
    },
    fail(err) {
      console.error('获取jpush注册id失败', err)
    }
  })
}

ログイン後にコピー

上記のコードでは、最初にデバイスの Aurora 登録 ID をキャッシュから取得しようとします。すでにキャッシュに存在する場合は、それが直接返されます。。キャッシュに存在しない場合は、uni-app の jpush プラグインの「getRegistrationID」メソッドを呼び出して、デバイスの登録 ID を取得します。このとき、成功したコールバック関数で返される「res」オブジェクトにはデバイスの登録ID情報が含まれています。この登録 ID をローカルストレージにキャッシュし、バックエンドサーバーに送信します。これにより、デバイスがインターネットに接続できない場合、サーバーはこの登録 ID を使用してオフラインメッセージを Aurora サーバーに一時的に保存できます。

4. アプリケーションの起動時にオフラインメッセージを確認する

デバイスがインターネットに再接続されたときに、Jiguang サーバーに一時的に保存されているオフラインメッセージを取得して、それらのメッセージをユーザー。このプロセスでは、アプリの起動時にデバイスにオフラインメッセージがあるかどうかを確認し、それらをユーザーに 1 つずつプッシュする必要があります。このロジックは次のコードで実装されています。

// 引入uni-app插件包
import { jpush } from '@uni/plugins'

// 在应用启动时检查离线消息
checkOfflineMessage()

/**
 * 应用启动时检查离线消息
 */
function checkOfflineMessage() {
  // 调用极光推送插件获取离线消息
  jpush.getOfflineMessage({
    success(res) {
      console.log('获取离线消息成功', res)
      // 将离线消息依次推送给用户
      res.forEach(message => pushMessageToUser(message))
    },
    fail(err) {
      console.error('获取离线消息失败', err)
    }
  })
}

/**
 * 推送离线消息给用户
 * @param {Object} message 
 */
function pushMessageToUser(message) {
  // 在这里将离线消息推送给用户
  // ...
}

ログイン後にコピー

上記のコードでは、アプリケーションがデバイスにオフラインメッセージがあるかどうかの確認を開始するときに、最初に「checkOfflineMessage」メソッドを呼び出します。このメソッドでは、uni-app の jpush プラグインの「getOfflineMessage」メソッドを呼び出して、オフラインメッセージを取得します。成功コールバック関数の「res」オブジェクトには、すべてのオフラインメッセージ情報が含まれています。ここでは、オフラインメッセージをユーザーに順番にプッシュできます。

概要

この記事の導入部を通じて、読者は Aurora オフラインメッセージング機能を uniapp アプリケーションに統合する方法を学ぶことができます。具体的には、次の手順が含まれます。