メインコンテンツへスキップ
OneSignalは、デバイス中心モデル(Player ID)からユーザー中心モデル(OneSignal ID)に更新されました。移行ガイダンスについては、User Model Migration Guideを参照してください。レガシーデバイス中心実装のドキュメントについては、Version 9を参照してください。
このページでは、OneSignalのPlayer ModelとUser Model SDKのメソッドおよびプロパティ名をマッピングします。これは、親しみやすさのために元のPlayer Model Client SDK Referenceのレイアウトを反映しています。Swift例はAPI変更を示していますが、これらは常に完全な動作サンプルであるとは限りません。他の言語での例と完全な実装の詳細については、リンクされたドキュメントを参照してください。

OneSignalの初期化

initWithLaunchOptions()

Player Model リファレンス
OneSignal.initWithLaunchOptions(launchOptions)
OneSignal.setAppId("ONESIGNAL_APP_ID")
User Model リファレンス
OneSignal.initialize("YOUR_ONESIGNAL_APP_ID", withLaunchOptions: launchOptions)

デバッグ

setLogLevel()

Player Model リファレンス
OneSignal.setLogLevel(.LL_VERBOSE, visualLevel: .LL_NONE)
User Model リファレンス
OneSignal.Debug.setLogLevel(.LL_VERBOSE)

外部ユーザーID

setExternalId()

Player Model リファレンス
OneSignal.setExternalId("EXTERNAL_USER_ID")
User Model リファレンス
OneSignal.login("EXTERNAL_USER_ID")

removeExternalUserId()

Player Model リファレンス
OneSignal.removeExternalUserId({ results in ... })
User Model リファレンス
OneSignal.logout()

タグ

sendTag()

Player Model リファレンス
OneSignal.sendTag("key", value: "value")
User Model リファレンス
OneSignal.User.addTag(key: "key", value: "value")

sendTags()

OneSignal.sendTags(["key1": "value1", "key2": "value2"])
OneSignal.User.addTags(["key1": "value1", "key2": "value2"])

getTags()

OneSignal.getTags({ tags in ..., onFailure: { error in ... })
let tags = OneSignal.User.getTags()

deleteTag()

OneSignal.deleteTag("key")
OneSignal.User.removeTag("key")

deleteTags()

OneSignal.deleteTags(["key1", "key2"])
OneSignal.User.removeTags(["key1", "key2"])

ユーザーデータ

notificationPermissionStatus

OneSignal.getDeviceState().notificationPermissionStatus
OneSignal.Notifications.permissionNative

userId

OneSignal.getDeviceState().userId
OneSignal.User.pushSubscription.id

hasNotificationPermission() / areNotificationsEnabled

OneSignal.getDeviceState().areNotificationsEnabled()
OneSignal.Notifications.permission

pushToken

OneSignal.getDeviceState().pushToken
OneSignal.User.pushSubscription.token

hasNotificationPermission

OneSignal.getDeviceState().hasNotificationPermission
OneSignal.User.pushSubscription.optedIn

isSubscribed [Dropped]

OneSignal.getDeviceState().isSubscribed
User Model: N/A

isPushDisabled [Dropped]

OneSignal.getDeviceState().isPushDisabled
User Model: N/A

setLanguage()

OneSignal.setLanguage("es")
OneSignal.User.setLanguage("en")

プライバシー

setRequiresUserPrivacyConsent()

OneSignal.setRequiresUserPrivacyConsent(true)
OneSignal.setConsentRequired(true)

consentGranted()

OneSignal.consentGranted(true)
OneSignal.setConsentGiven(true)

位置情報

setLocationShared()

OneSignal.setLocationShared(false)
OneSignal.Location.isShared = false

isLocationShared()

OneSignal.isLocationShared()
OneSignal.Location.isShared

promptLocation()

OneSignal.promptLocation()
OneSignal.Location.requestPermission()

サブスクリプションオブザーバー

addSubscriptionObserver()

OneSignal.addSubscriptionObserver(subscriptionObserver)
OneSignal.User.pushSubscription.addObserver(pushSubscriptionObserver)

removeSubscriptionObserver()

OneSignal.removeSubscriptionObserver(subscriptionObserver)
OneSignal.User.pushSubscription.removeObserver(pushSubscriptionObserver)

プッシュ通知

promptForPushNotifications()

OneSignal.promptForPushNotifications()
OneSignal.Notifications.requestPermission()

postNotification() [Dropped]

OneSignal.postNotification()
User Model: N/A

clearOneSignalNotifications()

OneSignal.clearOneSignalNotifications()
OneSignal.Notifications.clearAll()

disablePush()

OneSignal.disablePush(true)
OneSignal.User.pushSubscription.optOut()

unsubscribeWhenNotificationsAreDisabled() [Dropped]

OneSignal.unsubscribeWhenNotificationsAreDisabled(false)
User Model: N/A

setLaunchURLsInApp() [Dropped]

OneSignal.setLaunchURLsInApp(true)
User Model: N/A

registerForProvisionalAuthorization()

OneSignal.registerForProvisionalAuthorization({userResponse in ...})
OneSignal.Notifications.registerForProvisionalAuthorization({ userReponse in ... })

setNotificationWillShowInForegroundHandler()

OneSignal.setNotificationWillShowInForegroundHandler(foregroundHandler)
OneSignal.Notifications.addForegroundLifecycleListener(notificationLifecyleHandler)

setNotificationOpenedHandler()

OneSignal.setNotificationOpenedHandler(notificationOpenHandler)
OneSignal.Notifications.addClickListener(notificationClickListener)

addPermissionObserver()

OneSignal.addPermissionObserver(self as OSPermissionObserver)
OneSignal.Notifications.addPermissionObserver(notificationPermissionObserver)

removePermissionObserver()

OneSignal.removePermissionObserver()
OneSignal.Notifications.removePermissionObserver(notificationPermissionObserver)

ライブアクティビティ

enterLiveActivity()

OneSignal.enterLiveActivity("my_activity_id", withToken: myToken)
OneSignal.LiveActivities.enter("my_activity_id", withToken: "TOKEN")

exit()

OneSignal.exitLiveActivity("my_activity_id")
OneSignal.LiveActivities.exit("my_activity_id")

アプリ内メッセージ

addTrigger()

OneSignal.addTrigger("prompt_ios", withValue: "true");
OneSignal.InAppMessages.addTrigger("KEY", withValue: "VALUE")

addTriggers()

OneSignal.addTriggers(["trigger_key_1": "1", "trigger_key_2": "some_other_value"])
OneSignal.InAppMessages.addTriggers(["trigger_key_1": "1", "trigger_key_2": "some_other_value"])

removeTriggerForKey()

OneSignal.removeTriggerForKey("trigger_key_1");
OneSignal.InAppMessages.removeTrigger("trigger_key_1")

removeTriggerForKeys()

OneSignal.removeTriggerForKeys(["trigger_key_1", "trigger_key_2"])
OneSignal.InAppMessages.removeTriggers(["trigger_key_1", "trigger_key_2"])

getTriggerValueForKey() [Dropped]

OneSignal.getTriggerValueForKey("trigger_key");
User Model: N/A

inAppMessagesArePaused

OneSignal.inAppMessagesArePaused = true
OneSignal.InAppMessages.paused = true

setInAppMessageLifecycleHandler()

OneSignal.setInAppMessageLifecycleHandler(handler)
OneSignal.InAppMessages.addLifecycleListener(listener)

setInAppMessageClickHandler()

OneSignal.setInAppMessageClickHandler(clickHandler)
OneSignal.InAppMessages.addClickListener(clickListener)

メール

setEmail()

User Model doc
OneSignal.setEmail("email@example.com")
OneSignal.User.addEmail("email@example.com")

logoutEmail()

OneSignal.logoutEmail()
OneSignal.User.removeEmail("email@example.com")

SMS

setSMSNumber()

OneSignal.setSMSNumber("+11234567890")
OneSignal.User.addSms("+11234567890")

logoutSMSNumber()

OneSignal.logoutSMSNumber()
OneSignal.User.removeSms("+11234567890")

addSMSSubscriptionObserver() [Dropped]

OneSignal.add(subscriptionObserver)
User Model: N/A

getSMSId() [Dropped]

OneSignal.Default.SMSSubscriptionState.smsUserId
User Model: N/A

アウトカム

sendOutcome()

OneSignal.sendOutcome("Purchase")
OneSignal.Session.addOutcome("Purchase")

sendOutcomeWithValue()

OneSignal.sendOutcomeWithValue(withValue: "Purchase", value: 18.76)
OneSignal.Session.addOutcome("Purchase", 18.76)

sendUniqueOutcome()

OneSignal.sendUniqueOutcome("Swipe")
OneSignal.Session.addUniqueOutcome("Swipe")