AppIntent: এটি কী, Siri ইন্টেন্ট মডেল এবং Swift

AppIntent কী এবং কেন এটি প্রয়োজন?

AppIntent হল Apple-এর একটি ফ্রেমওয়ার্ক যা ডিক্লারেটিভভাবে কমান্ড বর্ণনা করার জন্য যা আপনার অ্যাপ Siri, Shortcuts, Spotlight, Control Center এবং Action Button-এর অনুরোধে কার্যকর করতে পারে। এর ভিত্তি হল AppIntent প্রোটোকল, যেখানে ডেভেলপার ইন্টেন্টের নাম, এর প্যারামিটার এবং perform() মেথড — কার্যকরযোগ্য লজিক বর্ণনা করে। ফ্রেমওয়ার্ক স্বয়ংক্রিয়ভাবে Shortcuts অ্যাপে প্যারামিটার কনফিগার করার জন্য ইউজার ইন্টারফেস এবং Siri-র জন্য ভয়েস ফ্রেজ জেনারেট করে।

AppIntent-এর আগে, ডেভেলপাররা Intents framework ব্যবহার করত — Intents Definition File-এর উপর ভিত্তি করে একটি সিস্টেম যা Objective-C কোড জেনারেট করত এবং আলাদা Intents Extension সেটআপ প্রয়োজন হত। এই প্রক্রিয়াটি জটিল ছিল: একটি সাধারণ ইন্টেন্টের জন্যও ৫টি কনফিগারেশন ফাইলের প্রয়োজন হত। AppIntent এই জটিলতা দূর করে — একটি ইন্টেন্ট একটি Swift ফাইলে বর্ণিত হয়, এবং সিস্টেম স্বয়ংক্রিয়ভাবে Siri এবং Shortcuts-এর সাথে ইন্টিগ্রেশনের জন্য প্রয়োজনীয় সবকিছু জেনারেট করে।

WWDC 2024 সেশন "Dive deeper into App Intents" অনুযায়ী, Apple AppIntent-কে ঐতিহ্যগত UI-এর বাইরে অ্যাপ কার্যকারিতা বাড়ানোর কেন্দ্রীয় প্রক্রিয়া হিসেবে দেখে। iOS 18 প্রকাশের সময়, App Store-এর শীর্ষ ১০০-এর মধ্যে ৭০% এরও বেশি অ্যাপ ইতিমধ্যে Shortcuts এবং Siri-এর সাথে ইন্টিগ্রেশনের জন্য AppIntent ব্যবহার করছে, এবং গড় iOS 18 ব্যবহারকারী ভয়েস কমান্ড বা উইজেটের মাধ্যমে প্রতিদিন ৪-৬টি ইন্টেন্ট চালায়।

AppIntent কোথায় ব্যবহৃত হয়

• Siri — ভয়েস কমান্ড: "Hey Siri, MyApp-এ একটি টাস্ক যোগ করুন"
• Shortcuts — প্যারামিটার কনফিগারেশন সহ শর্টকাট অ্যাপে অটোমেশন
• Spotlight — সার্চ বার থেকে সরাসরি সার্চ এবং কমান্ড কার্যকর করা
• Control Center — iOS 18+ এ দ্রুত অ্যাকশন বাটন
• Action Button — iPhone 15 Pro এবং নতুনের বাটনে অ্যাকশন অ্যাসাইন করা

AppIntent বনাম Intents framework: মূল পার্থক্য

Intents framework (iOS 10–15) এ .intentdefinition ফাইল তৈরি, Xcode-এর মাধ্যমে ObjC/Swift ক্লাস জেনারেট, Intents Extension এবং App Intent Configuration সেটআপ প্রয়োজন ছিল। AppIntent (iOS 16+) এই পাইপলাইনটি সম্পূর্ণরূপে জেনারেশন, এক্সটেনশন বা অতিরিক্ত কনফিগারেশন ছাড়াই বিশুদ্ধ Swift কোড দিয়ে প্রতিস্থাপন করে। এটি SiriKit অধ্যয়ন না করেই গড় iOS ডেভেলপারের জন্য ইন্টেন্ট তৈরি প্রক্রিয়াকে সুলভ করে তোলে।

AppIntent-এর মূল সুবিধা হল ডিক্লারেটিভনেস। ডেভেলপার বর্ণনা করে যে ইন্টেন্ট কী করে, না যে এটি সিস্টেমের সাথে কীভাবে ইন্টিগ্রেট হয়। ফ্রেমওয়ার্ক নিজেই Siri সংলাপ পরিস্থিতি, Shortcuts-এ প্যারামিটার প্রদর্শন এবং ইন্টেন্টের মধ্যে প্রসঙ্গ স্থানান্তর পরিচালনা করে। পুরোনো Intents framework-এ, ইন্টিগ্রেশনের প্রতিটি দিক ম্যানুয়ালি কোড করতে হত, যার মধ্যে ইন্টেন্ট UI প্রদর্শনের জন্য INUIHostedView-ও অন্তর্ভুক্ত ছিল।

পদ্ধতির তুলনা

প্রধান প্রোটোকল: AppIntent, AppEntity, AppEnum

AppIntent হল কেন্দ্রীয় প্রোটোকল যা একটি ইন্টেন্ট নির্ধারণ করে। এতে title (Siri-র জন্য নাম), description (Shortcuts-এ বিবরণ), প্যারামিটার (@Parameter-এর মাধ্যমে) এবং perform() মেথড যা IntentResult রিটার্ন করে। ফলাফল হতে পারে IntentDialog (Siri সংলাপ), Shortcuts-এ ফেরত দেওয়ার জন্য মান বা একটি ত্রুটি। প্রতিটি ইন্টেন্ট suggestedInvocationPhrase-ও সরবরাহ করতে পারে — ভয়েস ইনভোকেশনের জন্য একটি বাক্যাংশ।

AppEntity সত্তা বর্ণনা করে যাদের সাথে ইন্টেন্ট কাজ করে। উদাহরণস্বরূপ, যদি অ্যাপ প্রজেক্ট পরিচালনা করে, তাহলে AppEntity Project-এ id, displayRepresentation (UI-তে সত্তা কীভাবে প্রদর্শন করবেন) এবং defaultQuery (সত্তা কীভাবে সার্চ করবেন) অন্তর্ভুক্ত থাকে। AppEnum হল নির্বাচন প্যারামিটারের জন্য এনুমারেশন যা Shortcuts-এ পিকার এলিমেন্ট সহ স্বয়ংক্রিয়ভাবে UI জেনারেট করে। ম্যানুয়ালি প্যারামিটার তালিকা তৈরি করার পরিবর্তে, AppEnum-এর সাথে সামঞ্জস্যপূর্ণ enum ঘোষণা করাই যথেষ্ট।

AppEnum এবং প্যারামিটারের উদাহরণ

enum TaskPriority: String, AppEnum {
    case low, medium, high
    
    static var typeDisplayRepresentation: TypeDisplayRepresentation =
        "Priority"
    
    var displayRepresentation: DisplayRepresentation {
        switch self {
        case .low: "Low"
        case .medium: "Medium"
        case .high: "High"
        }
    }
}

struct CreateTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "Create Task"
    
    @Parameter(title: "Task Name")
    var taskName: String
    
    @Parameter(title: "Priority")
    var priority: TaskPriority
    
    func perform() async throws -> some IntentResult {
        try await TaskManager.shared
            .createTask(name: taskName, priority: priority)
        return .result(dialog: "Task created")
    }
}

ইন্টেন্ট প্যারামিটার এবং তাদের বৈধতা

AppIntent প্যারামিটার @Parameter প্রপার্টি র্যাপারের মাধ্যমে ঘোষণা করা হয়, যা স্বয়ংক্রিয়ভাবে Shortcuts UI এবং Siri ভয়েস অনুরোধের সাথে ইন্টিগ্রেট হয়। প্রতিটি প্যারামিটারের একটি title (Shortcuts-এ প্রদর্শিত) থাকে এবং এতে বিবরণ, ডিফল্ট মান এবং সীমাবদ্ধতা অন্তর্ভুক্ত থাকতে পারে। AppIntent স্ট্যান্ডার্ড টাইপ সমর্থন করে: String, Int, Double, Bool, পাশাপাশি AppEntity এবং AppEnum-এর মাধ্যমে কাস্টম টাইপ।

প্যারামিটার বৈধতা লজিক কার্যকর করার আগে perform() মেথডে করা হয়। যদি প্যারামিটারগুলি অবৈধ হয়, তাহলে ইন্টেন্ট IntentError-এর মাধ্যমে ত্রুটি রিটার্ন করে। জটিল বৈধতার জন্য, validate() মেথড প্রয়োগ করা যেতে পারে, যা perform()-এর আগে কল করা হয় এবং কমান্ড কার্যকর করার আগেই IntentDialog-এর মাধ্যমে ব্যবহারকারীকে প্রতিক্রিয়া জানাতে পারে। এটি Siri ভয়েস পরিস্থিতির জন্য বিশেষভাবে কার্যকর, যেখানে ব্যবহারকারীকে পুনরায় জিজ্ঞাসা করা ভুল কমান্ড কার্যকর করার চেয়ে সহজ।

বৈধতা সহ প্যারামিটার

struct SendMessageIntent: AppIntent {
    static var title: LocalizedStringResource = "Send Message"
    
    @Parameter(title: "Recipient")
    var recipient: String
    
    @Parameter(title: "Message")
    var message: String
    
    func validate() throws {
        guard message.count >= 1 else {
            throw IntentError.invalidMessage
        }
    }
    
    func perform() async throws -> some IntentResult {
        try await Messenger.shared
            .send(recipient: recipient, text: message)
        return .result(dialog: "Sent!")
    }
}

Swift-এ ইন্টেন্ট তৈরি: উদাহরণ

একটি অ্যাপে নোট সার্চ করার জন্য ইন্টেন্টের সম্পূর্ণ উদাহরণ AppEntity এবং EntityQuery-এর সাথে কাজ প্রদর্শন করে। SearchNotesIntent একটি সার্চ স্ট্রিং নেয় এবং পাওয়া নোটের তালিকা রিটার্ন করে। AppEntity Note নোটের গঠন বর্ণনা করে, এবং EntityQuery স্টোরেজ জুড়ে সার্চ বাস্তবায়ন করে। ফলাফল সত্তার একটি অ্যারের সাথে IntentResult-এর মাধ্যমে রিটার্ন করা হয়, যা Shortcuts ব্যবহারকারীকে প্রদর্শন করে।

struct Note: AppEntity {
    let id: UUID
    let title: String
    let content: String
    
    static var typeDisplayRepresentation: TypeDisplayRepresentation =
        "Note"
    
    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "(title)")
    }
}

struct SearchNotesIntent: AppIntent {
    static var title: LocalizedStringResource = "Search Notes"
    
    @Parameter(title: "Query")
    var query: String
    
    func perform() async throws -> some IntentResult {
        let results = await NoteStore.shared
            .search(query)
            .map { $0.toEntity() }
        return .result(value: results)
    }
}

Shortcuts এবং Siri-এর সাথে ইন্টিগ্রেশন

AppIntent ঘোষণা করার পর, Shortcuts এবং Siri-এর সাথে ইন্টিগ্রেশন স্বয়ংক্রিয়ভাবে ঘটে। Shortcuts অ্যাপ ইনস্টল করা অ্যাপ থেকে সমস্ত AppIntents স্ক্যান করে এবং উপলব্ধ অ্যাকশনের তালিকায় সেগুলি প্রদর্শন করে। ব্যবহারকারী তাদের শর্টকাটে একটি ইন্টেন্ট যোগ করতে পারে, এর প্যারামিটার কনফিগার করতে পারে এবং এটি অন্যান্য অ্যাকশনের সাথে একত্রিত করতে পারে। Siri-র জন্য, ডেভেলপারের পক্ষ থেকে অতিরিক্ত সেটআপ ছাড়াই ইন্টেন্ট ভয়েস কমান্ড হিসেবে উপস্থিত হয়।

ডেভেলপার suggestedInvocationPhrase যোগ করে ইন্টিগ্রেশন উন্নত করতে পারে — ভয়েস ইনভোকেশনের জন্য প্রস্তাবিত বাক্যাংশ। উদাহরণস্বরূপ, টাস্ক যোগ করার ইন্টেন্টের জন্য: suggestedInvocationPhrase = "Add new task"। Siri এই বাক্যাংশ বিশ্লেষণ করে এবং ভয়েস কমান্ড শেখার সময় ব্যবহারকারীকে এটি সুপারিশ করে। categories-ও নির্দিষ্ট করা যেতে পারে — ইন্টেন্ট ক্যাটাগরি (create, view, search, edit), যা Shortcuts-কে অর্থ অনুযায়ী অ্যাকশন গ্রুপ করতে সাহায্য করে।

Shortcuts-এর জন্য ইন্টেন্ট ক্যাটাগরি