Document forcePortrait Option for Landscape-Locked Games

[huda-stash]

Document forcePortrait Option for Landscape-Locked Games

Overview

This PR adds documentation and sample code comments to guide partners on using the existing forcePortrait option when their Unity games are locked to landscape orientation. This ensures checkout is always usable by displaying in portrait mode, even when the game itself is locked to landscape.

Problem

When a Unity game is locked to landscape orientation (defaultScreenOrientation: 4), the Stash checkout would also display in landscape mode, making it difficult or impossible for users to complete purchases. The checkout UI is designed for portrait orientation and doesn't work well in landscape.

Solution

The StashNative SDK already supports forcing portrait orientation via the forcePortrait flag in StashNativeCardConfig. This PR documents when and how partners should use this existing feature.

Changes

Documentation (README.md)

• Added guidance in the OpenCard() example showing how to use forcePortrait when game is locked to landscape
• Added a note explaining the requirement for landscape-locked games
• Updated the forcePortrait field description in the API reference to clarify when it's needed
• Clarified that portrait orientation must be enabled in Unity Player Settings (iOS: allowedAutorotateToPortrait: 1)

Sample Code (StashSample.cs)

• Added helpful comments in OpenCard() method explaining when to uncomment forcePortrait = true
• Added the same guidance in GenerateLinkAndOpen() method
• Kept forcePortrait commented out by default (partners enable it if needed)

Requirements

• iOS: Portrait orientation must be enabled in Unity Player Settings (allowedAutorotateToPortrait: 1 in ProjectSettings.asset)
• Android: No additional configuration needed
• Game can remain locked to landscape (defaultScreenOrientation: 4)

Usage

Partners with landscape-locked games should:

config.forcePortrait = true; // Force portrait for checkout

StashNative.Instance.OpenCard(checkoutUrl, 
    onDismiss: OnDismissed,
    onSuccess: OnSuccess,
    onFailure: OnFailure,
    config: config
);```