hig-technologies
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseApple HIG: Technologies
Apple HIG：技术集成指南
Check for before asking questions. Use existing context and only ask for information not already covered.
.claude/apple-design-context.md在提问前，请先查看。请基于已有上下文提问，仅询问未涵盖的信息。
.claude/apple-design-context.mdKey Principles
核心原则
General
通用原则
-
Apple technologies extend app capabilities through system integration. Each technology has established user-facing patterns; deviating creates confusion and erodes trust.
-
Privacy and user control are paramount. Especially for health, payment, and identity technologies. Request only needed data, explain why, respect choices.
-
苹果技术通过系统集成拓展应用能力。每项技术都有既定的用户交互模式；偏离这些模式会造成用户困惑，削弱用户信任。
-
隐私与用户控制权至关重要。对于健康、支付和身份类技术尤其如此。仅请求必要的数据，说明用途，尊重用户选择。
Siri and Voice
Siri与语音交互
- Natural, predictable, recoverable. Clear conversational intent phrases that complete quickly and confirm results. Support App Shortcuts for proactive suggestions. Handle errors with clear fallbacks.
- 自然、可预测、可恢复。使用清晰的对话意图短语，快速完成交互并确认结果。支持App Shortcuts以提供主动建议。出现错误时提供明确的fallback方案。
Payments and Commerce
支付与商务
- Transparent and frictionless. Standard Apple Pay button styles. Never ask for card details when Apple Pay is available. Clearly describe what the user is buying, the price, and whether it's one-time or subscription.
- 透明且流畅。使用标准的Apple Pay按钮样式。当支持Apple Pay时，切勿要求用户输入银行卡详情。清晰说明用户购买的内容、价格，以及是一次性购买还是订阅服务。
Health and Fitness
健康与健身
- Health data is deeply personal. Explain the health benefit before requesting access. CareKit tasks should be encouraging. ResearchKit consent flows must be thorough, readable, and respect autonomy.
- 健康数据极具私密性。在请求访问权限前，先说明对健康的益处。CareKit任务应具有鼓励性。ResearchKit的知情同意流程必须全面、易懂，并尊重用户自主权。
Smart Home
智能家居
- Simple and reliable. Immediate response when controlling devices. Clear device state. Graceful handling of connectivity issues.
- 简单可靠。控制设备时需即时响应。设备状态清晰明确。优雅处理连接问题。
Augmented Reality
增强现实
- Genuine value, not gimmicks. Use AR when spatial context improves understanding. Guide setup (surface, lighting, space). Provide clear exit back to standard interaction.
- 注重真实价值，而非噱头。当空间上下文能提升理解时再使用AR。引导用户完成设置（表面、光线、空间）。提供明确的退出方式，返回标准交互界面。
Machine Learning and Generative AI
机器学习与生成式AI
- Enhance without surprising. Smart suggestions, image recognition, text prediction. Clearly attribute AI-generated content. Controls to edit, regenerate, or dismiss. Let users correct mistakes.
- 增强体验而非制造意外。提供智能建议、图像识别、文本预测功能。明确标注AI生成内容。提供编辑、重新生成或关闭的控制选项。允许用户纠正错误。
Identity and Authentication
身份与认证
- Sign in with Apple as top option. Standard button styles. Respect email hiding preference. ID Verifier: guided flows, don't store sensitive data beyond what verification requires.
- 将Sign in with Apple设为首选选项。使用标准按钮样式。尊重用户隐藏邮箱的偏好。ID Verifier：采用引导式流程，仅存储验证所需的敏感数据，不额外存储。
Cloud and Data
云与数据
- Invisible and reliable sync. Data appears on all devices without manual intervention. Handle conflicts gracefully. Never lose data.
- 无形且可靠的同步。数据无需手动干预即可同步至所有设备。优雅处理冲突。绝不丢失用户数据。
Shared Experiences
共享体验
- Real-time participation. SharePlay: support multiple participants, show presence, handle latency. AirPlay: appropriate Now Playing metadata.
- 实时参与。SharePlay：支持多位参与者，显示在线状态，处理延迟问题。AirPlay：提供合适的Now Playing元数据。
Automotive
车载应用
- Driver safety first. Minimize interaction complexity, large touch targets, no distracting content. Only permitted app types: audio, messaging, EV charging, navigation, parking, quick food ordering.
- 驾驶员安全优先。最小化交互复杂度，使用大触控目标，避免分散注意力的内容。仅允许以下类型的应用：音频、消息、电动车充电、导航、停车、快速点餐。
Accessibility
无障碍设计
- Baseline requirement. Every element has a meaningful VoiceOver label, trait, and action. Support Dynamic Type, Switch Control, and other assistive technologies. Test entirely with VoiceOver enabled.
- 基础要求。每个元素都要有有意义的VoiceOver标签、特性和操作。支持动态字体、切换控制及其他辅助技术。全程使用VoiceOver进行测试。
Reference Index
参考索引
| Reference | Topic | Key content |
|---|---|---|
| siri.md | Siri | Intents, shortcuts, voice interaction, App Shortcuts |
| apple-pay.md | Apple Pay | Payment buttons, checkout flow, security |
| tap-to-pay-on-iphone.md | Tap to Pay | Merchant flows, contactless payment |
| in-app-purchase.md | In-app purchase | Subscriptions, one-time purchases, transparency |
| healthkit.md | HealthKit | Health data access, privacy, permissions |
| carekit.md | CareKit | Care plans, tasks, health management |
| researchkit.md | ResearchKit | Studies, informed consent, data collection |
| homekit.md | HomeKit | Smart home control, device state, scenes |
| augmented-reality.md | ARKit | Spatial context, surface detection, setup |
| machine-learning.md | Core ML | Predictions, smart features, confidence handling |
| generative-ai.md | Generative AI | Attribution, editing, responsible AI, uncertainty |
| icloud.md | iCloud | CloudKit, cross-device sync, conflict resolution |
| sign-in-with-apple.md | Sign in with Apple | Authentication, privacy, button styles |
| id-verifier.md | ID Verifier | Identity verification, document scanning |
| shareplay.md | SharePlay | Shared experiences, participant presence |
| airplay.md | AirPlay | Media streaming, Now Playing, wireless display |
| carplay.md | CarPlay | Driver safety, permitted app types, large targets |
| game-center.md | Game Center | Achievements, leaderboards, multiplayer |
| voiceover.md | VoiceOver | Screen reader, labels, traits, accessibility |
| wallet.md | Wallet | Passes, tickets, loyalty cards |
| nfc.md | NFC | Tag reading, quick interactions, App Clips |
| maps.md | Maps | Location display, annotations, directions |
| mac-catalyst.md | Mac Catalyst | iPad to Mac, menu bar, keyboard, pointer |
| live-photos.md | Live Photos | Motion capture, playback, editing |
| imessage-apps-and-stickers.md | iMessage apps | Messages extension, stickers, compact UI |
| shazamkit.md | ShazamKit | Audio recognition, music identification |
| always-on.md | Always-on display | Dimmed state, power efficiency, reduced updates |
| photo-editing.md | Photo editing | System photo editor, filters, adjustments |
| 参考文档 | 主题 | 核心内容 |
|---|---|---|
| siri.md | Siri | 意图、快捷指令、语音交互、App Shortcuts |
| apple-pay.md | Apple Pay | 支付按钮、结账流程、安全性 |
| tap-to-pay-on-iphone.md | Tap to Pay | 商家流程、非接触式支付 |
| in-app-purchase.md | 内购 | 订阅、一次性购买、透明度 |
| healthkit.md | HealthKit | 健康数据访问、隐私、权限 |
| carekit.md | CareKit | 护理计划、任务、健康管理 |
| researchkit.md | ResearchKit | 研究、知情同意、数据收集 |
| homekit.md | HomeKit | 智能家居控制、设备状态、场景 |
| augmented-reality.md | ARKit | 空间上下文、表面检测、设置 |
| machine-learning.md | Core ML | 预测、智能功能、置信度处理 |
| generative-ai.md | 生成式AI | 标注、编辑、负责任AI、不确定性 |
| icloud.md | iCloud | CloudKit、跨设备同步、冲突解决 |
| sign-in-with-apple.md | Sign in with Apple | 认证、隐私、按钮样式 |
| id-verifier.md | ID Verifier | 身份验证、文档扫描 |
| shareplay.md | SharePlay | 共享体验、参与者状态 |
| airplay.md | AirPlay | 媒体流、Now Playing、无线显示 |
| carplay.md | CarPlay | 驾驶员安全、允许的应用类型、大触控目标 |
| game-center.md | Game Center | 成就、排行榜、多人游戏 |
| voiceover.md | VoiceOver | 屏幕阅读器、标签、特性、无障碍 |
| wallet.md | Wallet | 通行证、票务、会员卡 |
| nfc.md | NFC | 标签读取、快速交互、App Clips |
| maps.md | Maps | 位置显示、标注、导航 |
| mac-catalyst.md | Mac Catalyst | iPad转Mac、菜单栏、键盘、指针 |
| live-photos.md | Live Photos | 动作捕捉、播放、编辑 |
| imessage-apps-and-stickers.md | iMessage应用 | 消息扩展、贴纸、紧凑UI |
| shazamkit.md | ShazamKit | 音频识别、音乐识别 |
| always-on.md | 常亮显示 | 变暗状态、电源效率、减少更新 |
| photo-editing.md | 照片编辑 | 系统照片编辑器、滤镜、调整 |
Output Format
输出格式
- Implementation checklist -- step-by-step requirements per Apple's guidelines.
- Required vs optional features for approval.
- Privacy and permission requirements -- data access, usage descriptions.
- User-facing flow from permission prompt through task completion.
- Testing guidance -- key scenarios including edge cases.
- 实施检查清单 -- 基于苹果规范的分步要求。
- 必填与可选功能（用于审核）。
- 隐私与权限要求 -- 数据访问、用途说明。
- 用户交互流程 从权限提示到任务完成的全流程。
- 测试指南 -- 关键场景，包括边缘情况。
Questions to Ask
需询问的问题
- Which Apple technology?
- Core use case?
- Which platforms?
- API requirements and entitlements reviewed?
- What data or permissions needed?
- 涉及哪项苹果技术？
- 核心使用场景是什么？
- 针对哪些平台？
- 是否已查看API要求与权限？
- 需要哪些数据或权限？
Related Skills
相关技能
- hig-inputs -- Input methods interacting with technologies (voice for Siri, Pencil for AR, gestures for Maps)
- hig-components-system -- Widgets, complications, Live Activities surfacing technology data
- hig-components-status -- Progress indicators for technology operations (sync, payment, AR loading)
Built by Raintree Technology · More developer tools
- hig-inputs -- 与技术交互的输入方法（如Siri的语音输入、AR的Pencil输入、Maps的手势操作）
- hig-components-system -- 展示技术数据的组件、小组件、Live Activities
- hig-components-status -- 技术操作的进度指示器（如同步、支付、AR加载）