Shoplive SDK 連携ガイド

// Xcode ▸ File ▸ Add Package Dependencies…
// https://github.com/shoplive/shoplive-sdk-ios   (Dependency Rule: Up to Next Major — 3.0.3)

// ターゲットには必要なライブラリだけを追加し、使うものだけを import します。
import ShoplivePlayerSDK     // 視聴 — ミッション 1〜7
import ShopliveStreamerSDK   // 配信 — ミッション 8 (配信を組み込む場合のみ)

// 共通(認証 · 設定 · ユーザー)の ShopliveCore は上記の SDK が一緒に取り込みます。
// Shoplive.initialize · setUser を使っても個別に import する必要はありません。

// settings.gradle.kts — Shoplive の Maven リポジトリを追加
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://sdk.shoplive.cloud/maven-repo") }
    }
}

// app/build.gradle.kts
dependencies {
    implementation("cloud.shoplive:shoplive-player-sdk:3.0.3")     // 視聴
    implementation("cloud.shoplive:shoplive-streamer-sdk:3.0.3")   // 配信
    // core は上記の SDK が自動的に取り込みます
}

# pubspec.yaml — Flutter 3.22 以上 · Dart 3.4 以上
dependencies:
  shoplive_player: 3.0.3     # 視聴(shoplive_core を含む)
  shoplive_streamer: 3.0.3   # 配信 — 必要な場合のみ

# ios/Podfile — iOS SDK は iOS 15 以上(pod install 時にフレームワークをダウンロード)
platform :ios, "15.0"
# Android: Shoplive の Maven リポジトリはプラグインが自動で追加します

// 1) アプリ起動時に 1 回
Shoplive.initialize(.init(accessKey: "YOUR_ACCESS_KEY"))
// 2) ユーザーの識別 — ログインユーザーのみ (未ログインなら省略、ミッション 3)
Shoplive.setUser(.token(jwt: myJwt))
// 3) 再生
let player = ShoplivePlayerViewController(campaignKey: "YOUR_CAMPAIGN_KEY")
present(player, animated: true)

// 1) アプリ起動時に 1 回
Shoplive.initialize(context, ShopliveConfiguration("YOUR_ACCESS_KEY"))
// 2) ユーザーの識別 — ログインユーザーのみ (未ログインなら省略、ミッション 3)
Shoplive.setUser(ShopliveUser.Token(myJwt))
// 3) 再生 (インスタンス生成と同時に開始)
ShoplivePlayer(context).start(campaignKey = "YOUR_CAMPAIGN_KEY")

import "package:shoplive_player/shoplive_player.dart";

// 1) アプリ起動時に 1 回
await Shoplive.initialize(const ShopliveConfiguration(accessKey: "YOUR_ACCESS_KEY"));
// 2) ユーザー識別 — ログインユーザーのみ(ゲストは省略、ミッション 3)
await Shoplive.setUser(ShopliveUser.token(myJwt));
// 3) 再生
await ShoplivePlayer.instance.start("YOUR_CAMPAIGN_KEY");

Shoplive.initialize(.init(accessKey: "YOUR_ACCESS_KEY"))
Shoplive.setStreamToken(streamerJwt)          // 配信専用トークン (必須)

let studio = ShopliveStreamerViewController(campaignKey: "YOUR_CAMPAIGN_KEY")
present(studio, animated: true)

Shoplive.initialize(context, ShopliveConfiguration("YOUR_ACCESS_KEY"))
Shoplive.setStreamToken(streamerJwt)          // 配信専用トークン (必須)

ShopliveStreamer(context).start(campaignKey = "YOUR_CAMPAIGN_KEY")

import "package:shoplive_streamer/shoplive_streamer.dart";

await Shoplive.initialize(const ShopliveConfiguration(accessKey: "YOUR_ACCESS_KEY"));
await Shoplive.setStreamToken(streamerJwt);   // 配信専用トークン(必須)

await ShopliveStreamer.instance.start("YOUR_CAMPAIGN_KEY");

@IBAction func watchLive() {
    let player = ShoplivePlayerViewController(campaignKey: "YOUR_CAMPAIGN_KEY")
    player.delegate = self               // 任意: イベント受信
    present(player, animated: true)
}

fun watchLive() {
    ShoplivePlayer(context).apply {
        delegate = myDelegate            // 任意: イベント受信
    }.start(campaignKey = "YOUR_CAMPAIGN_KEY")
}

Future<void> watchLive() async {
  final player = ShoplivePlayer.instance;
  player.events.listen(onPlayerEvent);   // 任意: イベントを受け取る(ミッション 6)
  await player.start("YOUR_CAMPAIGN_KEY");
}

// SceneDelegate
func scene(_ scene: UIScene, openURLContexts ctxs: Set<UIOpenURLContext>) {
    guard let url = ctxs.first?.url,
          let comps = URLComponents(url: url, resolvingAgainstBaseURL: false),
          let key = comps.queryItems?.first(where: { $0.name == "campaign" })?.value
    else { return }

    let referrer = comps.queryItems?.first(where: { $0.name == "ref" })?.value
    let player = ShoplivePlayerViewController(
        campaignKey: key,
        options: .init(referrer: referrer))
    topViewController?.present(player, animated: true)
}

// ディープリンク受信 Activity
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val data: Uri? = intent?.data           // myapp://live?campaign=XXXX
    val key = data?.getQueryParameter("campaign") ?: return
    val ref = data.getQueryParameter("ref")

    ShoplivePlayer(this).start(
        campaignKey = key,
        options = ShoplivePlayOptions(referrer = ref))
}

// アプリが受け取ったディープリンク URI で呼び出します(例: app_links · go_router)
Future<void> openLive(Uri uri) async {
  final key = uri.queryParameters["campaign"];   // myapp://live?campaign=XXXX
  if (key == null) return;
  final ref = uri.queryParameters["ref"];

  await ShoplivePlayer.instance.start(key,
      playOptions: ShoplivePlayOptions(referrer: ref));
}

// ① ログイン · セキュア認証 (推奨) — バックエンドが署名した JWT (ステップ 4)
Shoplive.setUser(.token(jwt: myJwt))

// ② ログイン · シンプル認証 — プロフィールを直接渡す (SDK が署名なしの JWT を作る)
Shoplive.setUser(.profile(
    id: hashedUserId,            // 生の ID ではなくハッシュを推奨 (ステップ 3)
    name: "ライブファン", age: 27, gender: .female,
    rank: 10))                    // ユーザーランク (-100 〜 100)

// ③ 未ログイン — 呼び出す必要はありません

// ログアウト — ユーザー情報(JWT・プロフィール)を消去し、配信用トークンもあわせて消去(accessKey・ゲスト識別子・UTM は保持)
Shoplive.logout()

// ① ログイン · セキュア認証 (推奨) — バックエンドが署名した JWT (ステップ 4)
Shoplive.setUser(ShopliveUser.Token(myJwt))

// ② ログイン · シンプル認証 — プロフィールを直接渡す (SDK が署名なしの JWT を作る)
Shoplive.setUser(ShopliveUser.Profile(
    id = hashedUserId,           // 生の ID ではなくハッシュを推奨 (ステップ 3)
    name = "ライブファン", age = 27, gender = ShopliveGender.FEMALE,
    rank = 10))                    // ユーザーランク (-100 〜 100)

// ③ 未ログイン — 呼び出す必要はありません

// ログアウト — ユーザー情報(JWT・プロフィール)を消去し、配信用トークンもあわせて消去(accessKey・ゲスト識別子・UTM は保持)
Shoplive.logout()

// ① ログイン · セキュア認証(推奨)— バックエンドが署名した JWT(ステップ 4)
await Shoplive.setUser(ShopliveUser.token(myJwt));

// ② ログイン · 簡易認証 — プロフィールを直接渡す(SDK が署名なしの JWT を生成)
await Shoplive.setUser(ShopliveUser.profile(
    id: hashedUserId,            // 元の ID よりハッシュを推奨(ステップ 3)
    name: "LiveFan", age: 27, gender: ShopliveGender.female,
    rank: 10));                    // ユーザー等級(-100〜100)

// ③ 未ログイン — 呼び出し不要

// ログアウト — ユーザー情報・トークンを消去
await Shoplive.logout();

// プレビュープリセット — 低解像度(type = .preview)・ミュート・オーバーレイ非表示・in-App PIP 設定をまとめて
let playerView = ShoplivePlayerView(configuration: .preview)
container.addSubview(playerView)       // Auto Layout はホストアプリの自由
playerView.delegate = self
playerView.play(campaignKey: "YOUR_CAMPAIGN_KEY")

val playerView = ShoplivePlayerView(context)   // XML/Compose(AndroidView) の配置は自由
// プレビュープリセット — 低解像度(PREVIEW)・ミュート・オーバーレイ非表示・in-App PIP 設定をまとめて
playerView.configuration = ShoplivePlayerConfiguration.PREVIEW
container.addView(playerView)

playerView.delegate = myDelegate
playerView.bindLifecycle(viewLifecycleOwner)   // pause/resume/release を自動化
playerView.play(campaignKey = "YOUR_CAMPAIGN_KEY")

// Flutter 3.0.3 にもフィードに埋め込むウィジェットはありません(ShoplivePlayerView なし)。
// 代替: プレビューストリームを小さなアプリ内 PIP ウィンドウで開始
await ShoplivePlayer.instance.start("YOUR_CAMPAIGN_KEY",
    playOptions: const ShoplivePlayOptions(presentationStyle: ShoplivePresentationStyle.pip),
    configuration: const ShoplivePlayerConfiguration(
        type: ShoplivePlayerType.preview,                            // プレビューストリーム(低解像度)
        sound: ShopliveSoundOptions(muteOnStart: true),              // ミュートで開始
        overlay: ShopliveOverlayOptions(ui: ShopliveOverlayUIMode.hidden),   // オーバーレイを非表示
        pip: ShoplivePipOptions(isInAppPipEnabled: true)));          // presentationStyle: pip に必要

playerView.stop()                      // プレビューは停止して
let player = ShoplivePlayerViewController(campaignKey: "YOUR_CAMPAIGN_KEY")   // 本解像度で新しく開く
present(player, animated: true)

playerView.stop()                      // プレビューは停止して
ShoplivePlayer(context).start(campaignKey = "YOUR_CAMPAIGN_KEY")   // デフォルト type = LIVE

// 本解像度で本視聴へ切り替え — iOS は開いているセッションのまま切り替え
await ShoplivePlayer.instance.start("YOUR_CAMPAIGN_KEY",
    configuration: const ShoplivePlayerConfiguration(type: ShoplivePlayerType.live));

let configuration = WKWebViewConfiguration()
configuration.allowsInlineMediaPlayback = true
configuration.userContentController.add(self, name: "ShopLiveAppInterface")   // WKWebView の生成前（この configuration で作る前）に登録
let webView = WKWebView(frame: .zero, configuration: configuration)

// WKScriptMessageHandler
func userContentController(_ controller: WKUserContentController,
                           didReceive message: WKScriptMessage) {
    guard message.name == "ShopLiveAppInterface",
          let campaignKey = message.body as? String else { return }
    playLive(campaignKey)   // ステップ 3 · ネイティブで再生
}

webView.addJavascriptInterface(ShopLiveAppInterface(activity), "ShopLiveAppInterface")

class ShopLiveAppInterface(private val activity: Activity) {
    @JavascriptInterface                     // バックグラウンドスレッドで呼ばれる
    fun postMessage(campaignKey: String) {
        activity.runOnUiThread { playLive(activity, campaignKey) }   // ステップ 3 · ネイティブで再生
    }
}

// webview_flutter — ページに window.ShopLiveAppInterface.postMessage を公開
controller.addJavaScriptChannel(
  "ShopLiveAppInterface",
  onMessageReceived: (JavaScriptMessage message) {
    playLive(message.message);   // ステップ 3 · ネイティブで再生
  },
);

func playLive(_ campaignKey: String) {
    let player = ShoplivePlayerViewController(campaignKey: campaignKey)
    present(player, animated: true)
}

fun playLive(context: Context, campaignKey: String) {
    ShoplivePlayer(context).start(campaignKey = campaignKey)
}

Future<void> playLive(String campaignKey) =>
    ShoplivePlayer.instance.start(campaignKey);

// ログインユーザー — 再生の直前に（ミッション 3）
Shoplive.setUser(.token(jwt: jwt))
// 続けてステップ 3 のとおり再生

// ログインユーザー — 再生の直前に（ミッション 3）
Shoplive.setUser(ShopliveUser.Token(jwt))
// 続けてステップ 3 のとおり再生

// ログインユーザー — 再生の直前に(ミッション 3)
await Shoplive.setUser(ShopliveUser.token(jwt));
// 続けてステップ 3 のとおり再生

player.enterPictureInPicture()      // 小さなウィンドウへ
player.exitPictureInPicture()       // 元に戻す
if player.isInPictureInPicture { /* … */ }

// 位置・倍率などは設定で
var cfg = ShoplivePlayerConfiguration()
cfg.pip.defaultPosition = .bottomRight
cfg.pip.scale = 0.4
cfg.pip.isOSPipEnabled = true

player.enterPictureInPicture()      // 小さなウィンドウへ
player.exitPictureInPicture()       // 元に戻す
if (player.isInPictureInPicture) { /* … */ }

// 位置・倍率などは設定で
val cfg = ShoplivePlayerConfiguration(
    pip = ShoplivePlayerConfiguration.PipOptions(
        defaultPosition = ShoplivePipPosition.BOTTOM_RIGHT,
        scale = 0.4f,
        isOSPipEnabled = true))     // OS PIP は Activity 方式専用

final player = ShoplivePlayer.instance;
await player.enterPictureInPicture();   // 小さなウィンドウへ
await player.exitPictureInPicture();    // 元の画面へ
if (await player.isInPictureInPicture()) { /* … */ }

// 位置・サイズなどは設定で(現在の設定に上書きマージ)
await player.setConfiguration(const ShoplivePlayerConfiguration(
    pip: ShoplivePipOptions(
        defaultPosition: ShoplivePipPosition.bottomRight,
        scale: 0.4,
        isOSPipEnabled: true)));   // Android: ホスト Activity に android:supportsPictureInPicture="true" も追加

var options = ShoplivePlayOptions()
options.presentationStyle = .pip            // 既定は .fullScreen

player.play(campaignKey: key, options: options)

ShoplivePlayer(this).start(
    campaignKey = key,
    options = ShoplivePlayOptions(
        presentationStyle = ShoplivePlayerPresentationStyle.PIP))   // 既定 FULLSCREEN

await ShoplivePlayer.instance.start(key,
    playOptions: const ShoplivePlayOptions(
        presentationStyle: ShoplivePresentationStyle.pip));   // 既定は fullscreen — pip.isInAppPipEnabled がオフなら INVALID_ARGUMENT

player.configuration = .preview                     // ミュート・オーバーレイ非表示・in-App PIP
player.play(campaignKey: key, options: .preview)    // presentationStyle = .pip

// プリセットを出発点にして調整（値型なのでコピーされます）
var cfg = ShoplivePlayerConfiguration.preview
cfg.pip.defaultPosition = .bottomLeft

ShoplivePlayer(this).start(
    campaignKey = key,
    options = ShoplivePlayOptions(presentationStyle = ShoplivePlayerPresentationStyle.PIP),
    configuration = ShoplivePlayerConfiguration(
        sound = ShoplivePlayerConfiguration.SoundOptions(muteOnStart = true),             // ミュート
        overlay = ShoplivePlayerConfiguration.OverlayOptions(ui = ShopliveOverlayUIMode.HIDDEN)))  // オーバーレイ非表示

// Flutter にはプリセットがありません — 同じ値を直接設定
await ShoplivePlayer.instance.start(key,
    playOptions: const ShoplivePlayOptions(presentationStyle: ShoplivePresentationStyle.pip),
    configuration: const ShoplivePlayerConfiguration(
        sound: ShopliveSoundOptions(muteOnStart: true),                       // ミュート
        overlay: ShopliveOverlayOptions(ui: ShopliveOverlayUIMode.hidden)));   // オーバーレイ非表示

extension MyViewController: ShoplivePlayerDelegate {

  // 通知 — 全ケース。必要な case だけ残して削除しても構いません
  func player(_ p: ShoplivePlayerControlling, didReceive event: ShoplivePlayerEvent) {
    switch event {
    case .stateChanged(let s):              // 再生ライフサイクル (.inAppPIP への移行/復帰を含む)
        print("state:", s)
    case .campaignStatusChanged(let c):     // .ready / .live / .ended
        liveBadge.isHidden = (c != .live)
    case .campaignInfoReceived(let info):   // キャンペーンのメタデータ受信 (タイトル・ブランドなど)
        titleLabel.text = info.title
    case .playback(let pb):                 // pb.event: .started / .rendering / .rebufferingStarted / .rebufferingEnded / .ended …
        if pb.event == .rebufferingStarted { spinner.isHidden = false }
        if pb.event == .rebufferingEnded { spinner.isHidden = true }
    case .connectionStateChanged(let cs):   // 共通の接続状態
        networkBanner.isHidden = (cs != .reconnecting)
    case .userNameUpdateRequested(let payload):  // ニックネーム変更のリクエスト → アプリのプロフィール画面
        openProfileEditor(payload)
    case .analytics(let info):              // 視聴統計 → 自社アナリティクスへ連携
        tracker.log(info.campaignKey, info.isPlaying, info.durationMs)
    case .error(let e):                     // 復旧不能なエラーのみ通知される
        show(e.message)
    case .webCommand(let name, let payload):  // オーバーレイ(Web)から届くカスタムコマンド — 例: ログイン要求
        handleWebCommand(name, payload)
    }
  }

  func player(_ p: ShoplivePlayerControlling, didRequest request: ShoplivePlayerRequest) {
    switch request {
    case .navigation(let url):  router.open(url)      // 商品/バナーのランディング
    case .coupon(let id, let respond):            // 発行処理の後に結果を返信 — status: ポップアップ処理(.show/.hide/.keep)、alertType: .alert/.toast
        respond(ShopliveCouponResult(couponId: id, success: true, status: .hide, alertType: .toast))
    case .customWebAction(let id, _, _, let respond):  // 動作を実行した後に結果を返信
        respond(ShopliveCustomActionResult(id: id, success: true, status: .keep, alertType: .toast))
    }
  }
}

val myDelegate = object : ShoplivePlayerDelegate {

  // 通知 — 全ケース。必要な case だけ残して削除しても構いません (既定実装は empty)
  override fun onEvent(p: ShoplivePlayerControlling, event: ShoplivePlayerEvent) {
    when (event) {
      is ShoplivePlayerEvent.StateChanged ->             // 再生ライフサイクル (IN_APP_PIP への移行/復帰を含む)
          log(event.state)
      is ShoplivePlayerEvent.CampaignStatusChanged ->    // READY / LIVE / ENDED
          liveBadge.isVisible = event.status == ShopliveCampaignStatus.LIVE
      is ShoplivePlayerEvent.CampaignInfoReceived ->     // キャンペーンのメタデータ受信 (タイトル・ブランドなど)
          titleView.text = event.info.title
      is ShoplivePlayerEvent.Playback -> when (event.event) {  // event.event: Started / Rendering / RebufferingStarted / RebufferingEnded / Ended …
          is ShoplivePlaybackEvent.RebufferingStarted -> spinner.isVisible = true
          is ShoplivePlaybackEvent.RebufferingEnded -> spinner.isVisible = false
          else -> Unit
      }
      is ShoplivePlayerEvent.ConnectionStateChanged ->   // 共通の接続状態
          networkBanner.isVisible = event.state == ShopliveConnectionState.RECONNECTING
      is ShoplivePlayerEvent.UserNameUpdateRequested ->  // ニックネーム変更のリクエスト → アプリのプロフィール画面
          openProfileEditor(event.payload)
      is ShoplivePlayerEvent.Analytics ->                // 視聴統計 → 自社アナリティクスへ連携
          tracker.log(event.info.campaignKey, event.info.isPlaying, event.info.durationMs)
      is ShoplivePlayerEvent.Error ->                    // 復旧不能なエラーのみ通知される
          show(event.error.message)
      is ShoplivePlayerEvent.WebCommandReceived ->      // オーバーレイ(Web)から届くカスタムコマンド — 例: ログイン要求
          handleWebCommand(event.name, event.payload)
    }
  }

  override fun onRequest(p: ShoplivePlayerControlling, request: ShoplivePlayerRequest) {
    when (request) {
      is ShoplivePlayerRequest.Navigation -> router.open(request.url)
      is ShoplivePlayerRequest.Coupon ->             // 発行処理の後に結果を返信 — status: ポップアップ処理(SHOW/HIDE/KEEP)、alertType: ALERT/TOAST
          request.respond(ShopliveCouponResult(couponId = request.id, success = true,
              status = ShopliveResultStatus.HIDE, alertType = ShopliveResultAlertType.TOAST))
      is ShoplivePlayerRequest.CustomWebAction ->    // 動作を実行した後に結果を返信
          request.respond(ShopliveCustomActionResult(id = request.id, success = true,
              status = ShopliveResultStatus.KEEP, alertType = ShopliveResultAlertType.TOAST))
    }
  }
}

final player = ShoplivePlayer.instance;

// 通知 — events ストリーム。必要な case だけ残して構いません
player.events.listen((event) {
  switch (event) {
    case ShoplivePlayerStateChanged(:final state):          // 再生ライフサイクル(inAppPip の開始・終了を含む)
      log(state);
    case ShopliveCampaignStatusChanged(:final status):      // ready / live / ended
      showLiveBadge(status == ShopliveCampaignStatus.live);
    case ShopliveCampaignInfoReceived(:final info):         // 配信メタ情報を受信(タイトル・ブランドなど)
      setTitle(info.title);
    case ShoplivePlaybackEvent(:final kind):                // 再生の種類: started / rendering / rebufferingStarted / rebufferingEnded / ended …
      if (kind == ShoplivePlaybackEventKind.rebufferingStarted) showSpinner(true);
      if (kind == ShoplivePlaybackEventKind.rebufferingEnded) showSpinner(false);
    case ShopliveConnectionStateChanged(:final state):      // 共通の接続状態
      showNetworkBanner(state == ShopliveConnectionState.reconnecting);
    case ShopliveUserNameUpdateRequested(:final payload):   // ニックネーム変更の要求 → アプリのプロフィール画面
      openProfileEditor(payload);
    case ShopliveAnalyticsEvent e:                          // 視聴統計 → 自社の分析へ転送
      tracker.log(e.campaignKey, e.isPlaying, e.durationMs);
    case ShoplivePlayerErrorEvent(:final error):            // 回復不能なエラーのみ届く
      show(error.message);
    case ShopliveWebCommandReceived(:final name, :final payload):   // オーバーレイ(Web)からのカスタムコマンド — 例: ログイン要求
      handleWebCommand(name, payload);
    default:
      break;
  }
});

// リクエスト — 種類ごとに 1 ストリーム。セッション中は購読を維持します
player.navigationRequests.listen((request) => router.open(request.url));
player.couponRequests.listen((request) {                    // 発行後に結果を報告(respond は 1 回のみ有効 · 既定 10 秒でタイムアウト)
  request.respond(const ShopliveCouponResult(success: true,
      status: ShopliveResultStatus.hide, alertType: ShopliveResultAlertType.toast));
});
player.customWebActionRequests.listen((request) {           // アクション実行後に結果を報告
  request.respond(const ShopliveCustomActionResult(success: true,
      status: ShopliveResultStatus.keep, alertType: ShopliveResultAlertType.toast));
});

player.send(command: "HIGHLIGHT_PRODUCT", payload: ["sku": "A-1024"])

player.send(command = "HIGHLIGHT_PRODUCT", payload = mapOf("sku" to "A-1024"))

await ShoplivePlayer.instance.send("HIGHLIGHT_PRODUCT", {"sku": "A-1024"});

var cfg = ShoplivePlayerConfiguration()
cfg.overlay.ui = .hidden        // 標準のオーバーレイ UI を隠す (コマンドチャネルは維持)
let player = ShoplivePlayerViewController(campaignKey: key, configuration: cfg)
// これ以降、チャット/商品/クーポンの UI はアプリが delegate のデータで自ら描画します

val cfg = ShoplivePlayerConfiguration(
    overlay = ShoplivePlayerConfiguration.OverlayOptions(ui = ShopliveOverlayUIMode.HIDDEN)   // 表示のみを隠す
)
ShoplivePlayer(context).start(campaignKey = key, configuration = cfg)
// これ以降、チャット/商品/クーポンの UI はアプリが delegate のデータで自ら描画します

await ShoplivePlayer.instance.start(key,
    configuration: const ShoplivePlayerConfiguration(
        overlay: ShopliveOverlayOptions(ui: ShopliveOverlayUIMode.hidden)));   // 表示のみ非表示
// これで events・リクエストストリームのデータからチャット・商品・クーポン UI をアプリが描画します

// 1) 配信トークン (必須)
Shoplive.setStreamToken(streamerJwt)

// 2) スタジオの起動
let studio = ShopliveStreamerViewController(campaignKey: "YOUR_CAMPAIGN_KEY")
studio.streamerDelegate = self          // 任意
present(studio, animated: true)

// 3) ステータス受信 (任意)
extension MyViewController: ShopliveStreamerDelegate {
  func streamer(_ s: ShopliveStreamerViewController, didReceive event: ShopliveStreamerEvent) {
    switch event {
    case .stateChanged(let st): print("broadcast:", st)
    case .error(let e):         show(e.message)
    }
  }
}

// 1) 配信トークン (必須)
Shoplive.setStreamToken(streamerJwt)

// 2) スタジオの起動 — ランタイム権限も SDK が要求
ShopliveStreamer(context).apply {
    streamerDelegate = myStreamerDelegate   // 任意
}.start(campaignKey = "YOUR_CAMPAIGN_KEY")

// 3) ステータス受信 (任意)
val myStreamerDelegate = object : ShopliveStreamerDelegate {
  override fun onEvent(s: ShopliveStreamer, event: ShopliveStreamerEvent) {
    when (event) {
      is ShopliveStreamerEvent.StateChanged -> log(event.state)
      is ShopliveStreamerEvent.Error -> show(event.error.message)
    }
  }
}

// 1) 配信トークン(必須)
await Shoplive.setStreamToken(streamerJwt);

final streamer = ShopliveStreamer.instance;
// 3) 状態を受け取る(任意)— start の前に購読
streamer.events.listen((event) {
  switch (event) {
    case ShopliveStreamerStateChanged(:final state):
      log(state);
    case ShopliveStreamerErrorEvent(:final error):
      show(error.message);
    default:
      break;
  }
});

// 2) スタジオを起動 — ランタイム権限の要求も SDK が処理
await streamer.start("YOUR_CAMPAIGN_KEY");

struct ShopliveError: Error {
    let code: ShopliveErrorCode        // 型付けされた enum
    let message: String
    let rawCode: Int           // 元の数値コード (3.0.3+、code が unknown でも保持)
    let underlying: Error?
    let isRecoverable: Bool    // コードごとの固定値 — true は SDK が再試行・再接続で自ら回復する種類
}

// 3.0.3 から視聴・配信で共通 — import cloud.shoplive.core.publicsurface.ShopliveError (· ShopliveErrorCode)
class ShopliveError(
    val code: ShopliveErrorCode,       // 型付けされた enum
    val rawCode: Int,                  // サーバー・エンジンが返した元の数値コード
    override val message: String?,
    override val cause: Throwable? = null,
    val isRecoverable: Boolean = code.isRecoverable,   // コードごとの固定値 — true は SDK が再試行・再接続で自ら回復する種類
) : Exception(message, cause)

// エラーイベントは ShopliveError を持ちます
class ShopliveError {
  final String code;          // SDK 3.0.3 のエラー定数名 — 値が増えることがあるため不透明な文字列として扱います
  final int? rawCode;         // 元の数値コード(3.0.3+ 両プラットフォームで値あり)
  final String? message;
  final bool recoverable;     // true なら SDK が自ら回復(再試行・再接続)
}

// すべての API は Future を返し、失敗時は PlatformException を投げます
// code: INVALID_ARGUMENT · NO_HOST_SCREEN · NOT_RUNNING · SDK_ERROR
try {
  await ShoplivePlayer.instance.start(campaignKey);
} on PlatformException catch (e) {
  if (e.code == ShoplivePlatformErrorCode.noHostScreen) { /* … */ }
}