Repository navigation
docs(android): ringing through the Calls SDK and Push Notifications SDK - #561
Open
hritika-cometchat wants to merge 7 commits into
Open
hritika-cometchat wants to merge 7 commits into
hritika-cometchat wants to merge 7 commits into
Conversation
…cations SDK Android calling no longer signals through the Chat SDK. The Calls SDK 5.1 creates, joins and ends calls; the Push Notifications SDK 2.0 calls module rings the device in every app state; the UI Kit hosts the screens. Calls SDK - Rewrite ringing.mdx for the Calls SDK-only flow (initiateCall, prepared session events, IncomingCallListener, answer/decline/cancel/end, group calls) - Rewrite voip-calling.mdx as "Push Ringing" (PNConfiguration, FCM service, answer activity, readiness, busy, missed calls, own ring screen, MANUAL) - Add migrating-from-legacy-ringing.mdx with the method-by-method mapping - setup: 5.1 version, host overrides, push dependencies, one-shot init - events: getActiveSession, onParticipantConnected, incoming-call and login listeners; actions/overview/custom-control-panel: leave(); migration guide: 5.0 to 5.1 section; troubleshooting rows UI Kit - Rewrite calling-integration.mdx; add ongoing-call.mdx (answer activity) - call-features, incoming-call (deprecated), outgoing-call, call-buttons, call-logs updated for the new flow - getting-started, methods, sound-manager, troubleshooting, llms, upgrading and color-resources edits (no extra dependency, logout, ring-screen colours) Notifications: rewrite android-push-notifications.mdx for Push SDK 2.0. Chat SDK v5: deprecation notes on calling-overview and the Call Listener. docs.json: two new nav entries. Versions are the planned public releases (calls 5.1.0, push 2.0.0, UI Kit 6.1.0); hold the merge until they are published. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
… from Ringing Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
… SDK calling is superseded not deprecated, real call event names, getting-started parity
hritika-cometchat
marked this pull request as ready for review
October 15, 2026 06:03
hritika-cometchat
requested review from
jitvarpatil and
mathews-cometchat
as code owners
October 15, 2026 06:03
5 tasks
…ing migration setting
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…DK internals The UI Kit has no Push SDK dependency, so the answer activity is a small app class that builds the call with CallRingingUtils.buildIncomingCall and opens CometChatOngoingCallActivity. Fix incoming-call to use real APIs. Remove MANUAL mode, token registrar options, diagnostics, decline-queue and identifier details. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7 of 11 tasks
…omingCallTheme) The Push SDK's incoming-call screen can now be themed in code, light and dark, and the UI Kit can pass its own theme to it. The docs still said there was no runtime theme API and listed six colour resources. - Push Ringing: setIncomingCallTheme in the setter table; the theming section now covers CometChatPNIncomingCallTheme (Mode, Colors, Kotlin and Java), saving across a killed process, the theme -> resource -> default order, and all eleven colour resources with their setters. Notes that the class is not the @style/CometChatPNIncomingCallTheme window style. - Push Notifications: setIncomingCallTheme row. - UI Kit calling integration: CometChatTheme.getIncomingCallTheme() and Compose incomingCallTheme(), the app's mapping function, the one-line setIncomingCallTheme, and which UI Kit colour feeds each field. - Color resources: eleven colours with the UI Kit colour, light and dark. - Incoming Call (deprecated): CometChatIncomingCallStyle -> theme field map, including what has no equivalent. - Call features: incoming call paragraph. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Android calling no longer signals through the Chat SDK. The Calls SDK 5.1 creates, joins and ends calls; the Push Notifications SDK 2.0 calls module rings the device in every app state (foreground, background, killed); the UI Kit hosts the screens. This PR updates every Android page that described the old flow and adds the two pages the new flow needs.
Consumer-facing wording is "ringing" and "legacy ringing"; the pages never say v1 or v2.
Calls SDK (
calls/android/)ringing.mdxrewritten: Calls SDK-only flow with a sequence diagram,CometChatCalls.initiateCall, prepared-session events ("ringing…" / answered),addIncomingCallListenerwith the reason table, answer from the answer activity, decline, cancel, ring timeout, end withleave(), call waiting, group calls, logout, status values.voip-calling.mdxrewritten as Push Ringing (slug kept, no redirect): dependencies,PNConfigurationsetter table, three-line FCM service, answer activity, permissions andensureRingReady/getDiagnostics/verifyPushSetup, how a ring ends, call during a call, missed calls, killed-app behaviour, staging hosts, tokens, own incoming-call screen, theming resources, MANUAL mode, troubleshooting.migrating-from-legacy-ringing.mdx(new, in the Migration Guide nav group): before/after diagrams, seven migration steps, a 16-row method mapping table, caller and callee screens before/after, checklist.setup: 5.1 version,overrideAdminHost / overrideClientHost / overrideCallsHost, push dependencies, one-shot init warning.events:getActiveSession,onParticipantConnected, prepared-session semantics, Incoming Call and Login listener sections.actions,overview,custom-control-panel:leave().migration-guide-v5: 5.0 → 5.1 section.troubleshooting: six ringing rows.UI Kit (
ui-kit/android/)calling-integration.mdxrewritten: five steps (dependencies,setEnableCalling, push config withsetAnswerActivity(CometChatOngoingCallActivity), permissions, logout), what the kit does from there, own-screen calls, ring-screen colours, upgrade pointer.ongoing-call.mdx(new, in the Components nav): the in-call screen and Push SDK answer activity.call-features,incoming-call(deprecated, kept forsetIncomingCallActivity),outgoing-call(call states,endReason, ViewModel members),call-buttons,call-logsupdated for the new flow.getting-started,getting-started-kotlin/-jetpack(no extra dependency,6.1.0),methods(new settings, logout behaviour),sound-manager,troubleshooting(16 calling rows),llms-android-v6,upgrading-from-v5(Ringing table),color-resources(sixcometchat_pn_call_*resources).Notifications and Chat SDK
notifications/android-push-notifications.mdxrewritten for Push SDK 2.0: automatic tokens,PNConfiguration, inline reply and tap listener, badge count kept app-side; VoIP/ConnectionService and manual-token sections removed.sdk/android/v5/calling-overviewandv5/real-time-listeners: notes that the Chat SDK calling APIs andCallListenerare superseded by the Calls SDK (deprecation lands with a coming Chat SDK release).Before merging
calls-sdk-android:5.1.0,push-notifications-android/push-notifications-calls-android:2.0.0, UI Kit6.1.0. Do not merge before they are published.api(Getting Started and Calling Integration say no extra dependency is needed).sample-app-kotlin-push/sample-app-compose-push; the notifications page links to the repository root.@Deprecatedannotations ships, change that wording to "deprecated".mint dev(links verified by file existence only).Related: ENG-39907.
🤖 Generated with Claude Code