axiom-media

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Media

媒体

You MUST use this skill for ANY camera, photo, audio, haptic, or media playback work.

任何涉及相机、照片、音频、触觉反馈或媒体播放的工作，都必须使用本技能。

Quick Reference

快速参考

Symptom / Task	Reference
Camera capture, AVCaptureSession	See `skills/camera-capture.md`
Camera API (RotationCoordinator, etc.)	See `skills/camera-capture-ref.md`
Camera freezes, black preview, rotation	See `skills/camera-capture-diag.md`
Photo pickers, library access	See `skills/photo-library.md`
PHPicker, PhotosPicker API reference	See `skills/photo-library-ref.md`
Audio, AVFoundation, spatial audio	See `skills/avfoundation-ref.md`
Audio recognition, ShazamKit	See `skills/shazamkit.md`
ShazamKit API reference	See `skills/shazamkit-ref.md`
Haptic feedback, Core Haptics	See `skills/haptics.md`
Now Playing metadata, remote commands	See `skills/now-playing.md`
CarPlay Now Playing	See `skills/now-playing-carplay.md`
MusicKit Now Playing	See `skills/now-playing-musickit.md`

症状/任务	参考资料
相机捕获、AVCaptureSession	查看 `skills/camera-capture.md`
相机API（RotationCoordinator等）	查看 `skills/camera-capture-ref.md`
相机冻结、预览黑屏、旋转问题	查看 `skills/camera-capture-diag.md`
照片选择器、相册访问	查看 `skills/photo-library.md`
PHPicker、PhotosPicker API参考	查看 `skills/photo-library-ref.md`
音频、AVFoundation、空间音频	查看 `skills/avfoundation-ref.md`
音频识别、ShazamKit	查看 `skills/shazamkit.md`
ShazamKit API参考	查看 `skills/shazamkit-ref.md`
触觉反馈、Core Haptics	查看 `skills/haptics.md`
Now Playing元数据、远程命令	查看 `skills/now-playing.md`
CarPlay Now Playing	查看 `skills/now-playing-carplay.md`
MusicKit Now Playing	查看 `skills/now-playing-musickit.md`

Decision Tree

决策树

dot

digraph media {
    start [label="Media task" shape=ellipse];
    what [label="Which media feature?" shape=diamond];

    start -> what;
    what -> "skills/camera-capture.md" [label="camera capture"];
    what -> "skills/photo-library.md" [label="photo pickers\n/ library"];
    what -> "skills/avfoundation-ref.md" [label="audio / AVFoundation"];
    what -> "skills/shazamkit.md" [label="ShazamKit\n/ audio recognition"];
    what -> "skills/haptics.md" [label="haptic feedback"];
    what -> "skills/now-playing.md" [label="Now Playing\n/ remote commands"];
}

Camera capture? →

skills/camera-capture.md

(patterns),

skills/camera-capture-ref.md

(API),

skills/camera-capture-diag.md

(debugging)

Photo pickers / library? →

skills/photo-library.md

skills/photo-library-ref.md

Audio / AVFoundation? →
```
skills/avfoundation-ref.md
```

ShazamKit / audio recognition? →

skills/shazamkit.md

skills/shazamkit-ref.md

Haptics? →
```
skills/haptics.md
```

Now Playing / remote commands? →

skills/now-playing.md

skills/now-playing-carplay.md

skills/now-playing-musickit.md

Want camera code audit? → Launch
```
camera-auditor
```
agent

dot

digraph media {
    start [label="Media task" shape=ellipse];
    what [label="Which media feature?" shape=diamond];

    start -> what;
    what -> "skills/camera-capture.md" [label="camera capture"];
    what -> "skills/photo-library.md" [label="photo pickers\n/ library"];
    what -> "skills/avfoundation-ref.md" [label="audio / AVFoundation"];
    what -> "skills/shazamkit.md" [label="ShazamKit\n/ audio recognition"];
    what -> "skills/haptics.md" [label="haptic feedback"];
    what -> "skills/now-playing.md" [label="Now Playing\n/ remote commands"];
}

相机捕获？→

skills/camera-capture.md

（模式）、

skills/camera-capture-ref.md

（API）、

skills/camera-capture-diag.md

（调试）

照片选择器/相册？→

skills/photo-library.md

、

skills/photo-library-ref.md

音频/AVFoundation？→
```
skills/avfoundation-ref.md
```

ShazamKit/音频识别？→

skills/shazamkit.md

、

skills/shazamkit-ref.md

触觉反馈？→
```
skills/haptics.md
```

Now Playing/远程命令？→

skills/now-playing.md

、

skills/now-playing-carplay.md

、

skills/now-playing-musickit.md

需要相机代码审计？→ 启动
```
camera-auditor
```
agent

Cross-Domain Routing

跨领域路由

Camera + permissions (camera access denied, Info.plist missing):

Camera code → stay here (camera-capture)
Privacy manifest / Info.plist → invoke axiom-integration (privacy-ux reference)
Build/entitlement errors → invoke axiom-build

ShazamKit + microphone permissions:

Microphone NSMicrophoneUsageDescription → invoke axiom-integration (privacy-ux reference)
ShazamKit API and matching → stay here (shazamkit)

Now Playing + background audio:

Now Playing metadata/controls → stay here (now-playing)
Background audio mode / BGTaskScheduler → invoke axiom-integration (background-processing reference)

Photo library + privacy:

Photo picker (PHPicker, PhotosPicker) → stay here (photo-library) — no permissions needed
Full PHPhotoLibrary access → stay here (photo-library-ref) — limited access model
Privacy manifest for photo usage → invoke axiom-integration (privacy-ux reference)

相机+权限（相机访问被拒绝、Info.plist缺失）：

相机代码 → 留在本技能（camera-capture）
隐私清单/Info.plist → 调用axiom-integration（隐私UX参考）
构建/权限错误 → 调用axiom-build

ShazamKit+麦克风权限：

麦克风NSMicrophoneUsageDescription → 调用axiom-integration（隐私UX参考）
ShazamKit API与匹配 → 留在本技能（shazamkit）

Now Playing+后台音频：

Now Playing元数据/控制 → 留在本技能（now-playing）
后台音频模式/BGTaskScheduler → 调用axiom-integration（后台处理参考）

相册+隐私：

照片选择器（PHPicker、PhotosPicker）→ 留在本技能（photo-library）——无需权限
完整PHPhotoLibrary访问 → 留在本技能（photo-library-ref）——有限访问模型
照片使用隐私清单 → 调用axiom-integration（隐私UX参考）

Anti-Rationalization

认知误区

Thought	Reality
"Camera capture is just AVCaptureSession setup"	Camera has interruption handlers, rotation, and threading requirements.
"I'll add haptics with a simple API call"	Haptic design has patterns for each interaction type matching HIG.
"ShazamKit is just SHSession + a delegate"	iOS 17+ has SHManagedSession which eliminates all AVAudioEngine boilerplate.
"Now Playing info is just setting metadata"	Remote commands, artwork handling, and state sync have 15+ gotchas.
"I'll use UIImagePickerController for photos"	PHPicker/PhotosPicker are the modern API — no permissions required.

想法	实际情况
"相机捕获只是AVCaptureSession的设置"	相机需要中断处理程序、旋转适配和线程要求。
"我用简单的API调用添加触觉反馈就行"	触觉设计有对应每种交互类型的模式，需符合HIG规范。
"ShazamKit只是SHSession+委托"	iOS 17+提供的SHManagedSession可消除所有AVAudioEngine样板代码。
"Now Playing信息只是设置元数据"	远程命令、 artwork处理和状态同步有15+个易出错点。
"我用UIImagePickerController处理照片"	PHPicker/PhotosPicker是现代API——无需权限。

Example Invocations

调用示例

User: "How do I set up a camera preview?" → Read:

skills/camera-capture.md

User: "Camera freezes when I get a phone call" → Read:

skills/camera-capture-diag.md

User: "How do I let users pick photos in SwiftUI?" → Read:

skills/photo-library.md

User: "Implement haptic feedback for button taps" → Read:

skills/haptics.md

User: "Now Playing info doesn't appear on Lock Screen" → Read:

skills/now-playing.md

User: "How do I identify songs with ShazamKit?" → Read:

skills/shazamkit.md

User: "Check my camera code for issues" → Launch:

camera-auditor

agent

用户："如何设置相机预览？" → 阅读：

skills/camera-capture.md

用户："接电话时相机冻结" → 阅读：

skills/camera-capture-diag.md

用户："如何在SwiftUI中让用户选择照片？" → 阅读：

skills/photo-library.md

用户："为按钮点击实现触觉反馈" → 阅读：

skills/haptics.md

用户："Now Playing信息未显示在锁屏上" → 阅读：

skills/now-playing.md

用户："如何用ShazamKit识别歌曲？" → 阅读：

skills/shazamkit.md

用户："检查我的相机代码是否有问题" → 启动：

camera-auditor

agent