iOS 26 SpeechAnalyzer Live Mic: الإعداد والنتائج واستكشاف الأخطاء وإصلاحها

SpeechTranscriber يوفر جهاز وقت التشغيل والفحوصات المحلية. فحص إصدار iOS وحده غير كاف. يقوم المساعد التالي بإرجاع ناسخ ومحلل وتنسيق صوت تم تكوينه، أو يلقي خطأ إعداد محدد.

قم بتنزيل مساعد إعداد Swift الكامل. يتضمن الملف الكامل الواردات وأنواع النتائج والأخطاء ومساعد تلميح DictationTranscriber الذي تمت مناقشته أدناه. هذا مكون إعداد، وليس تطبيق تسجيل كامل.

@available(iOS 26.0, *)
@MainActor
public func prepareSpeechAnalyzer(
    requestedLocale: Locale,
    naturalFormat: AVAudioFormat? = nil
) async throws -> PreparedSpeechAnalyzer {
    guard SpeechTranscriber.isAvailable else {
        throw SpeechPreparationError.deviceUnavailable
    }
    guard let locale = await SpeechTranscriber.supportedLocale(
        equivalentTo: requestedLocale
    ) else {
        throw SpeechPreparationError.unsupportedLocale
    }

    let transcriber = SpeechTranscriber(
        locale: locale,
        preset: .progressiveTranscription
    )
    // The system may already have the asset; nil means no install is needed.
    // A request can automatically reserve the locale or throw if no slot is free.
    if let request = try await AssetInventory.assetInstallationRequest(
        supporting: [transcriber]
    ) {
        try await request.downloadAndInstall()
    }
    try Task.checkCancellation()
    guard await AssetInventory.status(forModules: [transcriber]) == .installed else {
        throw SpeechPreparationError.assetsNotInstalled
    }
    guard let format = await SpeechAnalyzer.bestAvailableAudioFormat(
        compatibleWith: [transcriber], considering: naturalFormat
    ) else {
        throw SpeechPreparationError.noCompatibleFormat
    }

    let analyzer = SpeechAnalyzer(modules: [transcriber])
    try await analyzer.prepareToAnalyze(in: format)
    return PreparedSpeechAnalyzer(
        locale: locale, transcriber: transcriber,
        analyzer: analyzer, audioFormat: format
    )
}

AssetInventory يدير نماذج النظام المشتركة. قد يكون النموذج مثبتا بالفعل بواسطة النظام أو تطبيق آخر. طلب التثبيت يرجع nil عندما لا تكون هناك حاجة إلى التثبيت؛ وإلا فإنه يمكن حجز اللغة وبدء التنزيل. يمكن أن تؤدي حدود الحجز أيضا إلى حدوث خطأ. قم بإدارة الحجوزات عبر ميزات تطبيقك، وأصدر لغة عندما لم تعد هناك حاجة إليها بدلا من إصدار نموذج لا يزال قيد الاستخدام في مكان آخر في تطبيقك.

قبل عدم الاتصال بالإنترنت، قم بإعداد اللغة المطلوبة وتحقق من الاستعداد. تعيش أصول النموذج خارج حزمة التطبيقات، ولكنها لا تزال تستهلك تخزين النظام ويمكن أن تتغير بمرور الوقت. أظهر تقدم التنزيل والإلغاء في واجهة المستخدم المضيفة. "التعرف على الجهاز" لا يعني "لا حاجة إلى إعداد أو الوصول إلى الشبكة."

AVAudioEngine microphone tap
  -> owned PCM / conversion for the selected format
  -> AsyncStream<AnalyzerInput>
  -> SpeechAnalyzer + SpeechTranscriber
  -> result consumer and UI state

بعد تنشيط الجلسة الصوتية، افحص التنسيق الفعلي لعقدة الإدخال. لا تقم بتشفير معدل العينة لأن الجهاز أو الطريق غالبا ما يستخدم هذا المعدل من قبل. قم بتمرير تنسيق طبيعي إلى bestAvailableAudioFormat(compatibleWith:considering:) عند الاقتضاء وقم بفك نتيجته الاختيارية. يوثق Apple أن المحلل لا يعيد أخذ عينات أو يحول المدخلات بشفافية.

يقوم المستودع AudioBufferConverter بإرجاع المخزن المؤقت المطابق بالفعل دون تغيير ويستخدم AVAudioConverter عندما تختلف التنسيقات. التحويل مطلوب للتنسيقات غير المتطابقة، وليس كخطوة إضافية شاملة لكل مخزن مؤقت. تحقق من طول إطار الإخراج وأخطاء تحويل التقرير؛ يمكن أن يؤدي إسقاط كل مخزن مؤقت فاشل بصمت إلى جعل واجهة مستخدم التسجيل تبدو صحية أثناء عدم إنتاج أي نص.

امنح الصوت في قائمة الانتظار سياسة ملكية صريحة. يقوم محول العينة المحدث بإرجاع تخزين PCM مستقل حتى عندما تتطابق التنسيقات بالفعل، لذلك لا تقوم إعادة استخدام الإدخال لاحقا بالكتابة فوق الصوت في قائمة الانتظار. يجب عدم افتراض أن المخزن المؤقت الذي يوفره رد الاتصال الصوتي يظل ثابتا بعد عودة رد الاتصال. إذا قمت بوضعه في قائمة الانتظار لاستخدامه لاحقا، فقم بترتيب نسخة مملوكة مناسبة أو خط أنابيب يتم التحكم في عمر المخزن المؤقت الخاص به. احتفظ بطفرات واجهة المستخدم لكل مخزن من المخزن المؤقت بعيدا عن رد الاتصال الصوتي. بالنسبة للإنتاج، حدد أيضا كيفية ربط العمل في قائمة الانتظار والتعامل مع الحمل الزائد أو تغييرات الطريق.

في Swift 6، التقاط المتغيرات المحلية لا يثبت في حد ذاته أن خط الأنابيب آمن للخيوط. يحتوي محول العينة الحالي على عقد خيط معالجة واحد وحامل @unchecked Sendable خاص محمي بالقفل لرد اتصال محول واحد. لا يجعل جميع مخازن PCM أو المحول آمنا بشكل عام للمشاركة عبر مؤشرات الترابط. اقرأ هذا العقد قبل تكييف العينة.

من غير الدقيق القول إن الكلام الجديد API لا يحتوي على دعم للمفردات السياقية. وثائق Apple AnalysisContext.contextualStrings ل DictationTranscriber. توصي الوثائق بعبارات موجزة وعلى الأكثر عبارات 100 عبر العلامات. هذا ليس وعدا بأن نفس التلميحات تخصص SpeechTranscriber.

// For an analyzer configured with DictationTranscriber.
let context = AnalysisContext()
context.contextualStrings[.general] = ["Obsidian", "Yurica"]
try await analyzer.setContext(context)

setContext(_:) يحل محل السياق الحالي، لذا احتفظ بأي سياق تطبيق موجود أو دمجه عند الحاجة. يرفض المساعد القابل للتنزيل أكثر من عبارات 100 بدلا من اقتطاعها بصمت. تختلف تلميحات العبارة عن خيار نموذج اللغة المخصص الموثق أيضا ل DictationTranscriber، ولا يضمن أي منهما التعرف الصحيح على كل اسم. اختر الوحدة واللغة التي يحتاجها تطبيقك واختبرها.

بالنسبة للتشخيصات، ابدأ بتوقيتات المرحلة، وعدد الإطارات، واللغة، ومعلومات الخطأ. ليست هناك حاجة للتسجيلات الأولية والنص المعترف به لكل إدخال سجل. إذا شارك المستخدم نسخة، فاطلب عبارة اختبار قصيرة غير حساسة والتكوين ذي الصلة بدلا من محادثة خاصة.