系统语言

【Android】系统语言用于智能视频创作 SDK 的多语言界面展示、文案适配等场景，通常由 Android 系统默认 Locale 提供。

// 获取系统语言，用于多语言文案适配
val locale = Locale.getDefault()
val language = locale.language
val country = locale.country

传感器信息

1. 加速度计

2. 陀螺仪

3. 重力传感器

4. 游戏旋转向量

5. 旋转向量

【Android】传感器信息用于智能视频创作 SDK 特效相关功能运行。通过 Android SensorManager 的 registerListener 接口开启采集，并在场景结束或页面销毁时通过 unregisterListener 接口关闭采集。

// 以下示例为宿主应用自行采集传感器数据时的开启 / 关闭方式
val sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
val sensors = listOf(
    sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER),        // 获取加速度计数据
    sensorManager.getDefaultSensor(Sensor.TYPE_GYROSCOPE),            // 获取陀螺仪数据
    sensorManager.getDefaultSensor(Sensor.TYPE_GRAVITY),              // 获取重力传感器数据
    sensorManager.getDefaultSensor(Sensor.TYPE_GAME_ROTATION_VECTOR), // 获取游戏旋转向量数据
    sensorManager.getDefaultSensor(Sensor.TYPE_ROTATION_VECTOR)       // 获取旋转向量数据
)
sensors.forEach { sensor ->
    sensorManager.registerListener(listener, sensor, SensorManager.SENSOR_DELAY_GAME)
}

// 关闭采集
sensorManager.unregisterListener(listener)

系统权限设置

【Android】该项用于声明及申请智能视频创作 SDK 相关功能运行所需的系统权限。宿主应用需根据实际启用能力，在 AndroidManifest.xml 中声明相机、麦克风、图片、视频、音频等相应权限，并在调用对应系统能力前通过运行时权限申请获得用户授权；若宿主应用不声明、不申请或用户拒绝授权，将无法使用对应能力，SDK 也不会读取相应信息。

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED" />
<uses-permission
    android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />
<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

// 调用相机、麦克风、相册等能力前申请对应权限；不申请或未授权则不读取相应信息
EOUtils.permission.checkPermissions(activity, requiredPermissions, {
    // 权限通过后再使用对应能力
}, {
    // 权限未通过时提示用户授权
})

系统语言

系统语言用于应用及智能视频创作相关界面的本地化文案选择。当前示例工程的 LocaleUtil 通过 NSLocale.preferredLanguages.first 获取首选语言，并从主 Bundle 已支持的本地化资源中选择对应语言；未匹配时回退至英文资源。
该读取不涉及系统授权弹窗。若宿主不使用该本地化工具或不展示该模块的本地化界面，可不调用该语言获取逻辑；同时应自行提供固定语言或其他本地化策略。

let language = NSLocale.preferredLanguages.first
// 仅在需要按系统首选语言选择本地化资源时读取。
// 不调用该逻辑时，宿主可使用固定语言或自有语言策略。

传感器信息（设备运动、重力及方向信息）

视频创作中的特效能力如依赖设备姿态或画面方向校正，可能使用特效引擎的内置传感器或宿主的 Core Motion 数据。当前工程可见的特效引擎配置入口为 bef_effect_ai_use_builtin_sensor(handle, true)；宿主方向检测可通过 CMMotionManager 的 startDeviceMotionUpdatesToQueue:withHandler: 启动，并通过 stopDeviceMotionUpdates 停止。
如不启用依赖设备姿态的特效，可在初始化前将 SDK 内置传感器配置为 false，且不要启动宿主设备运动更新；如果仅关闭其中一条路径，另一条仍可能访问相应信息。关闭后，方向校正及依赖姿态的特效效果可能不可用或表现受限。

// 初始化特效引擎前，按需关闭 SDK 内置传感器。
bef_effect_ai_use_builtin_sensor(handle, false);

// 如宿主自行开启了设备运动更新，场景结束时停止。
[motionManager stopDeviceMotionUpdates];

图片、视频、音频

图片和视频用于拍摄、从相册选择素材、编辑和导出；音频用于带声音的视频录制或编辑。当前工程中的相册选择由相册组件读取用户选择的媒体资源，拍摄入口调用系统相机录制视频，导出完成后可按用户操作写入相册。应用在构建配置中声明了 NSCameraUsageDescription、NSMicrophoneUsageDescription、NSPhotoLibraryUsageDescription 与 NSPhotoLibraryAddUsageDescription。
用途说明仅用于声明用途，实际访问应在用户主动进入拍摄、选择素材或保存成片等功能时申请或检查对应授权。宿主不展示或不调用拍摄入口时，不应请求相机、麦克风权限；不展示或不调用相册选择、保存入口时，不应读取或写入相册。用户拒绝授权时，应禁用对应功能，不读取相应媒体内容。

// 仅在用户主动进入拍摄功能时请求相机授权。
[AVCaptureDevice requestAccessForMediaType:AVMediaTypeVideo
    completionHandler:^(BOOL granted) {
        if (granted) {
            // 创建并启动宿主相机会话。
        } else {
            // 不启动拍摄，也不读取相机画面。
        }
    }];

// 仅在需要录制声音时请求麦克风授权。
[[AVAudioSession sharedInstance] requestRecordPermission:^(BOOL granted) {
    // 未获授权时禁用带音频的录制能力。
}];