更新记录

1.1（2025-05-07）

1. 完成Android端功能开发

1.0.0（2025-04-28）

1、提交第一个版本，先支持iOS平台。

平台兼容性

uni-app(4.01)

uni-app x(4.01)

其他

hy-oneSignal

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS

纯国外服务推送平台，基于oneSignal封装的UTS插件，支持iOS、Android，可自定义推送渠道（HUAWEI、FCM等）

使用说明

原SDK叫做OneSignal，官网是OneSignal,使用前需在官方注册账号并创建应用,可参考开发文档(非常详细)。 推送可以在OneSignal官网上dashboard进行推送，也可以通过RestApi进行推送，推送功能丰富。

1. 推送。 (1) Dashboard后台推送，类似极光、个推，可自定义各种参数

(2)利用Postman RestApi推送

2. 查看订阅。查看成功集成并初始化的设备，方便检测集成中的问题

3. 查看推送历史。可以查看送达数、CTR等信息

这是一款OneSignal的uts插件，用于uniapp在iOS和Android端集成推送功能，且完全是使用纯海外服务。 目前暴露以下几个api，如有业务需要可定制增加其他api。

//初始化
export declare function initOSPush() : void

//设置消息监听
export declare function addListener(notiCallback : HYNotificationCallback) : void

//登录，设置externalId
export declare function login(externalId : string) : void

//退出登录，清空alias
export declare function logout() : void

//设置alias
export declare function setAlias(alias_label : string, value : string) : void

/在uniapp和uniappX中的具体使用:/

一、头文件导入

import * as OSPush from '@/uni_modules/hy-oneSignal'

二、方法调用

在App.vue或其他合适的地方(根据业务需求)中完成登录,并设置别名alias以及收到推送的监听方法

2.1 初始化
OSPush.initOSPush()

2.2 登录
OSPush.login('xhy')

2.3 设置别名
OSPush.setAlias('alias', '1217')

2.4 设置监听方法
OSPush.addListener((notification) => {
    // 监听通知栏消息的点击
    if (notification.type == 'click') {
        console.log('点击了通知栏消息', notification)
    }
    // 监听在线推送消息
    if (notification.type == 'display') {
        console.log('接收到的消息内容', notification)
    }
})