rnww-plugin-screen-pinning 1.0.0

package/README.md

@@ -0,0 +1,57 @@
+# RNWW Plugin Screen Pinning
+
+React Native와 WebView 간 화면 고정(Screen Pinning) 기능을 연결하는 플러그인입니다. (Android 전용)
+
+## 설치
+
+```bash
+npm install rnww-plugin-screen-pinning
+# or
+yarn add rnww-plugin-screen-pinning
+```
+
+## 기능
+
+- 앱 고정(Screen Pinning / Lock Task Mode) 시작 및 해제
+- 앱 고정 상태 확인
+- Android 전용 (API Level 21+)
+
+### 브릿지 핸들러
+
+다음 이벤트 핸들러가 등록됩니다:
+
+- `getScreenPinning` - 앱 고정 상태 확인
+- `startScreenPinning` - 앱 고정 시작
+- `stopScreenPinning` - 앱 고정 해제
+
+### 사용법
+
+#### 앱 고정 시작
+```javascript
+bridge.send('startScreenPinning', {}, (response) => {
+  if (response.success) {
+    console.log('Screen pinning started');
+  }
+});
+```
+
+#### 앱 고정 해제
+```javascript
+bridge.send('stopScreenPinning', {}, (response) => {
+  if (response.success) {
+    console.log('Screen pinning stopped');
+  }
+});
+```
+
+#### 앱 고정 상태 확인
+```javascript
+bridge.send('getScreenPinning', {}, (response) => {
+  console.log('Is pinned:', response.isPinned);
+  console.log('Lock task mode state:', response.lockTaskModeState);
+});
+```
+
+## 라이선스
+
+MIT

package/lib/bridge/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 화면 고정 브릿지 메인 엔트리 포인트
+ *
+ * NPM 패키지로 사용 시 이 파일을 import하세요.
+ */
+export { registerScreenPinningHandlers } from './screen-pinning-bridge';
+export type { ScreenPinningBridgeConfig } from './screen-pinning-bridge';
+export * from '../types';
+//# sourceMappingURL=index.d.ts.map

package/lib/bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGzE,cAAc,UAAU,CAAC"}

package/lib/bridge/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * 화면 고정 브릿지 메인 엔트리 포인트
+ *
+ * NPM 패키지로 사용 시 이 파일을 import하세요.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScreenPinningHandlers = void 0;
+// 메인 export (의존성 주입 방식)
+var screen_pinning_bridge_1 = require("./screen-pinning-bridge");
+Object.defineProperty(exports, "registerScreenPinningHandlers", { enumerable: true, get: function () { return screen_pinning_bridge_1.registerScreenPinningHandlers; } });
+// 타입 정의
+__exportStar(require("../types"), exports);

package/lib/bridge/screen-pinning-bridge.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 앱 고정(Screen Pinning) 관련 핸들러 - Android 전용
+ */
+import type { IBridge, IPlatform, IScreenPinningModule } from '../types';
+/**
+ * 화면 고정 브릿지 설정
+ */
+export interface ScreenPinningBridgeConfig {
+    /**
+     * 브릿지 구현체
+     */
+    bridge: IBridge;
+    /**
+     * 플랫폼 구현체
+     */
+    platform: IPlatform;
+    /**
+     * 화면 고정 모듈 인스턴스
+     * 이 패키지의 src/module/index.ts를 직접 전달
+     */
+    screenPinningModule: IScreenPinningModule;
+    /**
+     * 로거 (선택적)
+     */
+    logger?: {
+        log: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+    };
+}
+/**
+ * 화면 고정 브릿지 핸들러를 등록합니다
+ * @param config 브릿지 설정
+ */
+export declare const registerScreenPinningHandlers: (config: ScreenPinningBridgeConfig) => void;
+//# sourceMappingURL=screen-pinning-bridge.d.ts.map

package/lib/bridge/screen-pinning-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-pinning-bridge.d.ts","sourceRoot":"","sources":["../../src/bridge/screen-pinning-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,OAAO,EACP,SAAS,EACT,oBAAoB,EACvB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,EAAE,oBAAoB,CAAC;IAE1C;;OAEG;IACH,MAAM,CAAC,EAAE;QACL,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAC9B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;KACnC,CAAC;CACL;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,yBAAyB,SAmD9E,CAAC"}

package/lib/bridge/screen-pinning-bridge.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * 앱 고정(Screen Pinning) 관련 핸들러 - Android 전용
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScreenPinningHandlers = void 0;
+/**
+ * 화면 고정 브릿지 핸들러를 등록합니다
+ * @param config 브릿지 설정
+ */
+const registerScreenPinningHandlers = (config) => {
+    const { bridge, platform, screenPinningModule: ScreenPinning, logger = console } = config;
+    // Android만 지원
+    if (platform.OS !== 'android') {
+        logger.log('[Bridge] ScreenPinning handlers skipped (Android only)');
+        return;
+    }
+    // 앱 고정 상태 확인
+    bridge.registerHandler('getScreenPinning', async (_payload, respond) => {
+        try {
+            const status = await ScreenPinning.isScreenPinned();
+            respond({ success: true, ...status });
+        }
+        catch (error) {
+            respond({
+                success: false,
+                isPinned: false,
+                lockTaskModeState: 0,
+                error: error instanceof Error ? error.message : 'Failed to get screen pinning status'
+            });
+        }
+    });
+    // 앱 고정 시작
+    bridge.registerHandler('startScreenPinning', async (_payload, respond) => {
+        try {
+            const result = await ScreenPinning.startScreenPinning();
+            respond(result);
+        }
+        catch (error) {
+            respond({
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to start screen pinning'
+            });
+        }
+    });
+    // 앱 고정 해제
+    bridge.registerHandler('stopScreenPinning', async (_payload, respond) => {
+        try {
+            const result = await ScreenPinning.stopScreenPinning();
+            respond(result);
+        }
+        catch (error) {
+            respond({
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to stop screen pinning'
+            });
+        }
+    });
+    logger.log('[Bridge] ScreenPinning handlers registered');
+};
+exports.registerScreenPinningHandlers = registerScreenPinningHandlers;

package/lib/types/bridge.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 브릿지 통신 추상화 인터페이스
+ */
+/**
+ * 브릿지 통신 인터페이스
+ * 기존 프로젝트와의 호환성을 위해 타입을 느슨하게 설정
+ */
+export interface IBridge {
+    /**
+     * 네이티브에서 호출할 수 있는 핸들러를 등록합니다
+     * @param eventName 이벤트 이름
+     * @param handler 핸들러 함수
+     */
+    registerHandler(eventName: string, handler: any): void;
+    /**
+     * 웹으로 메시지를 전송합니다
+     * @param eventName 이벤트 이름
+     * @param data 전송할 데이터
+     */
+    sendToWeb(eventName: string, data: any): void;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/lib/types/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/types/bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;IAEvD;;;;OAIG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;CAC/C"}

package/lib/types/bridge.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * 브릿지 통신 추상화 인터페이스
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 타입 정의 모음
+ */
+export * from './platform';
+export * from './bridge';
+export * from './screen-pinning-module';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC"}

package/lib/types/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * 타입 정의 모음
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./platform"), exports);
+__exportStar(require("./bridge"), exports);
+__exportStar(require("./screen-pinning-module"), exports);

package/lib/types/platform.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 플랫폼 추상화 인터페이스
+ */
+export interface IPlatform {
+    /**
+     * 현재 실행 중인 플랫폼
+     */
+    OS: 'ios' | 'android' | 'windows' | 'macos' | 'web';
+}
+//# sourceMappingURL=platform.d.ts.map

package/lib/types/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,EAAE,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;CACrD"}

package/lib/types/platform.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/screen-pinning-module.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 화면 고정 모듈 인터페이스
+ */
+/**
+ * 화면 고정 상태
+ */
+export interface ScreenPinningStatus {
+    /** 앱 고정 활성화 여부 */
+    isPinned: boolean;
+    /** Lock Task 모드 상태 (0: none, 1: pinned, 2: locked) */
+    lockTaskModeState: number;
+}
+/**
+ * 화면 고정 모듈 인터페이스
+ */
+export interface IScreenPinningModule {
+    /**
+     * 앱 고정 상태 확인
+     */
+    isScreenPinned(): Promise<ScreenPinningStatus>;
+    /**
+     * 앱 고정 시작
+     */
+    startScreenPinning(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 앱 고정 해제
+     */
+    stopScreenPinning(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=screen-pinning-module.d.ts.map

package/lib/types/screen-pinning-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-pinning-module.d.ts","sourceRoot":"","sources":["../../src/types/screen-pinning-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/C;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEpE;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE"}

package/lib/types/screen-pinning-module.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * 화면 고정 모듈 인터페이스
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "rnww-plugin-screen-pinning",
+  "version": "1.0.0",
+  "description": "React Native WebView Screen Pinning Plugin with Expo support (Android Only)",
+  "main": "lib/bridge/index.js",
+  "types": "lib/bridge/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "clean": "rimraf lib"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "screen-pinning",
+    "lock-task",
+    "kiosk-mode",
+    "android",
+    "webview",
+    "bridge",
+    "expo-module"
+  ],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "lib/",
+    "src/modules/",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "expo": "*",
+    "expo-modules-core": "*"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-native": "^0.73.0",
+    "rimraf": "^5.0.10",
+    "typescript": "^5.9.3"
+  }
+}

package/src/modules/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Mon Dec 29 03:54:07 JST 2025
+gradle.version=8.9

package/src/modules/android/build.gradle

@@ -0,0 +1,64 @@
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+apply plugin: 'maven-publish'
+
+group = 'expo.modules.screenpinning'
+version = '1.0.0'
+
+buildscript {
+  def expoModulesCoreProject = rootProject.findProject(":expo-modules-core")
+  if (expoModulesCoreProject != null) {
+    def expoModulesCorePlugin = new File(expoModulesCoreProject.projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
+    if (expoModulesCorePlugin.exists()) {
+      apply from: expoModulesCorePlugin
+      applyKotlinExpoModulesCorePlugin()
+    }
+  }
+}
+
+afterEvaluate {
+  publishing {
+    publications {
+      release(MavenPublication) {
+        from components.release
+      }
+    }
+    repositories {
+      maven {
+        url = mavenLocal().url
+      }
+    }
+  }
+}
+
+android {
+  namespace "expo.modules.screenpinning"
+  compileSdkVersion safeExtGet("compileSdkVersion", 34)
+
+  defaultConfig {
+    minSdkVersion safeExtGet("minSdkVersion", 23)
+    targetSdkVersion safeExtGet("targetSdkVersion", 34)
+  }
+  
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+  
+  kotlinOptions {
+    jvmTarget = JavaVersion.VERSION_17
+  }
+}
+
+repositories {
+  mavenCentral()
+}
+
+dependencies {
+  implementation project(':expo-modules-core')
+  implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlinVersion"
+}
+
+def safeExtGet(prop, fallback) {
+  rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}

package/src/modules/android/src/main/AndroidManifest.xml

@@ -0,0 +1,10 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <!-- 카메라 권한 -->
+  <uses-permission android:name="android.permission.CAMERA"/>
+  <!-- 비디오 녹화 시 오디오 권한 -->
+  <uses-permission android:name="android.permission.RECORD_AUDIO"/>
+  
+  <!-- 카메라 하드웨어 기능 (선택사항) -->
+  <uses-feature android:name="android.hardware.camera" android:required="false"/>
+  <uses-feature android:name="android.hardware.camera.autofocus" android:required="false"/>
+</manifest>

package/src/modules/android/src/main/java/expo/modules/screenpinning/ScreenPinningModule.kt

@@ -0,0 +1,103 @@
+package expo.modules.screenpinning
+
+import android.app.Activity
+import android.app.ActivityManager
+import android.content.Context
+import android.os.Build
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+import expo.modules.kotlin.Promise
+
+class ScreenPinningModule : Module() {
+    override fun definition() = ModuleDefinition {
+        Name("ScreenPinning")
+
+        // 앱 고정 상태 확인
+        AsyncFunction("isScreenPinned") { promise: Promise ->
+            try {
+                val activity = appContext.currentActivity
+                if (activity == null) {
+                    promise.resolve(mapOf(
+                        "isPinned" to false,
+                        "lockTaskModeState" to 0
+                    ))
+                    return@AsyncFunction
+                }
+
+                val activityManager = activity.getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
+                val lockTaskModeState = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                    activityManager.lockTaskModeState
+                } else {
+                    @Suppress("DEPRECATION")
+                    if (activityManager.isInLockTaskMode) 1 else 0
+                }
+
+                // LOCK_TASK_MODE_NONE = 0, LOCK_TASK_MODE_PINNED = 1, LOCK_TASK_MODE_LOCKED = 2
+                promise.resolve(mapOf(
+                    "isPinned" to (lockTaskModeState != ActivityManager.LOCK_TASK_MODE_NONE),
+                    "lockTaskModeState" to lockTaskModeState
+                ))
+            } catch (e: Exception) {
+                promise.resolve(mapOf(
+                    "isPinned" to false,
+                    "lockTaskModeState" to 0,
+                    "error" to e.message
+                ))
+            }
+        }
+
+        // 앱 고정 시작
+        AsyncFunction("startScreenPinning") { promise: Promise ->
+            try {
+                val activity = appContext.currentActivity
+                if (activity == null) {
+                    promise.resolve(mapOf(
+                        "success" to false,
+                        "error" to "Activity not available"
+                    ))
+                    return@AsyncFunction
+                }
+
+                // startLockTask()는 사용자에게 확인 다이얼로그를 표시
+                // Device Owner 앱인 경우 다이얼로그 없이 바로 고정됨
+                activity.startLockTask()
+                
+                promise.resolve(mapOf(
+                    "success" to true
+                ))
+            } catch (e: Exception) {
+                promise.resolve(mapOf(
+                    "success" to false,
+                    "error" to e.message
+                ))
+            }
+        }
+
+        // 앱 고정 해제
+        AsyncFunction("stopScreenPinning") { promise: Promise ->
+            try {
+                val activity = appContext.currentActivity
+                if (activity == null) {
+                    promise.resolve(mapOf(
+                        "success" to false,
+                        "error" to "Activity not available"
+                    ))
+                    return@AsyncFunction
+                }
+
+                // stopLockTask()는 Device Owner 앱에서만 프로그래밍 방식으로 해제 가능
+                // 일반 앱은 뒤로가기 + 최근 앱 버튼 동시 길게 누르기로 해제
+                activity.stopLockTask()
+                
+                promise.resolve(mapOf(
+                    "success" to true
+                ))
+            } catch (e: Exception) {
+                promise.resolve(mapOf(
+                    "success" to false,
+                    "error" to e.message
+                ))
+            }
+        }
+    }
+}

package/src/modules/android/src/main/res/xml/file_provider_paths.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 크래시 로그 파일 공유를 위한 경로 -->
+    <external-files-path name="crash_logs" path="." />
+</paths>

package/src/modules/expo-module.config.json

@@ -0,0 +1,6 @@
+{
+  "platforms": ["android"],
+  "android": {
+    "modules": ["expo.modules.screenpinning.ScreenPinningModule"]
+  }
+}

package/src/modules/index.ts

@@ -0,0 +1,60 @@
+/**
+ * Screen Pinning Module (Android Only)
+ * Android 앱 고정 (Screen Pinning / Lock Task Mode) 기능
+ */
+
+import { requireNativeModule } from 'expo-modules-core';
+import { Platform } from 'react-native';
+
+// Android에서만 네이티브 모듈 로드
+const ScreenPinningModule = Platform.OS === 'android' 
+  ? requireNativeModule('ScreenPinning')
+  : null;
+
+export interface ScreenPinningStatus {
+  /** 앱 고정 활성화 여부 */
+  isPinned: boolean;
+  /** Lock Task 모드 상태 (0: none, 1: pinned, 2: locked) */
+  lockTaskModeState: number;
+}
+
+/**
+ * 앱 고정 상태 확인
+ * @returns 앱 고정 상태 정보
+ */
+export async function isScreenPinned(): Promise<ScreenPinningStatus> {
+  if (Platform.OS !== 'android' || !ScreenPinningModule) {
+    return { isPinned: false, lockTaskModeState: 0 };
+  }
+  return await ScreenPinningModule.isScreenPinned();
+}
+
+/**
+ * 앱 고정 시작
+ * 사용자에게 확인 다이얼로그가 표시됩니다.
+ * Device Owner 앱인 경우 다이얼로그 없이 바로 고정됩니다.
+ */
+export async function startScreenPinning(): Promise<{ success: boolean; error?: string }> {
+  if (Platform.OS !== 'android' || !ScreenPinningModule) {
+    return { success: false, error: 'Only supported on Android' };
+  }
+  return await ScreenPinningModule.startScreenPinning();
+}
+
+/**
+ * 앱 고정 해제
+ * 일반 앱: 뒤로가기 + 최근 앱 버튼 동시 길게 누르기로 해제
+ * Device Owner 앱: 프로그래밍 방식으로 해제 가능
+ */
+export async function stopScreenPinning(): Promise<{ success: boolean; error?: string }> {
+  if (Platform.OS !== 'android' || !ScreenPinningModule) {
+    return { success: false, error: 'Only supported on Android' };
+  }
+  return await ScreenPinningModule.stopScreenPinning();
+}
+
+export default {
+  isScreenPinned,
+  startScreenPinning,
+  stopScreenPinning,
+};