ac-docs/COMMERCIAL.md

Commercial features (developer-gated)

Field	Value
Author	Anton Afanasyeu
Revision	R1
Creation date	2026-05-22
Last modification date	2026-05-22
Co-authored
Severity	medium
State	postponed
Document type	draft

\newpage \newpage

---

Ads, in-app purchases, and Play Store helpers are disabled for normal users. Turn them on only in Developer settings while testing monetization.

---

---

---

---

---

---

---

---

---

Table of contents

• Developer toggles
• Before production
• Code map

Documentation index: README.md

---

Developer toggles

Setting	Effect
Enable in-app ads	Initializes InAppAdCoordinator (placeholder UI; AdMob not linked yet)
Enable in-app purchases	Connects Google Play Billing; placeholder SKU androidcast_premium
Enable Play Store integration	Allows listing intent + in-app review API

Changing a toggle calls CommercialFeatures.refreshFromPreferences().

Before production

1. Create app in Google Play Console and add in-app products matching InAppPurchaseCoordinator.SKU_PREMIUM.
2. Add AdMob App ID to AndroidManifest.xml and replace InAppAdCoordinator placeholder with real ad units.
3. Privacy policy + ads declaration if using ads.
4. Remove or hide developer toggles in release builds (optional BuildConfig.DEBUG guard).

Code map

• com.foxx.androidcast.commercial.CommercialFeatures
• InAppPurchaseCoordinator — Billing Client 7.x
• InAppAdCoordinator — stub
• PlayStoreIntegration — market:// + Play In-App Review