अपने Android ऐप में टिप्पणियाँ जोड़ें

अपने कोडिंग एजेंट को FastComments का वह संदर्भ दें जिसकी उसे आवश्यकता है - विजेट्स, कॉन्फ़िगरेशन, Secure SSO, REST API, और SDKs:

npx skills add fastcomments/skills

यह Claude Code, Codex, Cursor, Copilot, Gemini, और skills CLI द्वारा समर्थित हर अन्य एजेंट के साथ काम करता है।

• 🔄 रीयल-टाइम अपडेट के साथ लाइव कमेंटिंग
• 📱 नेटिव Android UI कंपोनेंट्स
• 🧵 रिप्लाई के साथ थ्रेडेड चर्चाएँ
• 👤 सुरक्षित SSO प्रमाणीकरण
• 👍 अनुकूलन योग्य स्टाइल के साथ वोटिंग सिस्टम
• 🔔 यूज़र नोटिफिकेशन और प्रेज़ेंस
• 🔍 कमेंट मॉडरेशन क्षमताएँ
• 📱 सोशल फ़ीड इंटीग्रेशन
• ♾️ इनफिनिट स्क्रॉल पेजिनेशन
• 🎨 व्यापक थीमिंग

• Android SDK 26+ (Android 8.0 Oreo या बाद का)
• Java 8+

अपने ऐप की build.gradle.kts फ़ाइल में FastComments SDK जोड़ें:

dependencies {
    implementation("com.fastcomments:sdk:2.0.0")
}

सुनिश्चित करें कि आपके प्रोजेक्ट की settings.gradle.kts में Repsy रिपॉज़िटरी मौजूद है:

dependencyResolutionManagement {
    repositories {
        maven {
            url = uri("https://repo.repsy.io/mvn/winrid/fastcomments")
        }
        // अन्य रिपॉज़िटरी...
    }
}

1. अपने लेआउट में FastCommentsView जोड़ें

<com.fastcomments.sdk.FastCommentsView
    android:id="@+id/commentsView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2. SDK को इनिशियलाइज़ और कॉन्फ़िगर करें

// SDK कॉन्फ़िगर करें
val config = CommentWidgetConfig(
    "your-tenant-id", 
    "page-url-id", 
    "Page Title", 
    "yourdomain.com", 
    "Site Name"
)

// अतिरिक्त कॉन्फ़िगरेशन विकल्प
config.voteStyle = VoteStyle.UpDown // या VoteStyle.Heart
config.enableInfiniteScrolling = true
config.hasDarkBackground = true // डार्क मोड सपोर्ट के लिए

// SDK को इनिशियलाइज़ करें
val sdk = FastCommentsSDK(config)

// अपने लेआउट में कमेंट्स व्यू खोजें
val commentsView = findViewById<FastCommentsView>(R.id.commentsView)

// व्यू के लिए SDK इंस्टेंस सेट करें
commentsView.setSDK(sdk)

// कमेंट्स लोड करें
commentsView.load()

अपने उपयोगकर्ताओं के लिए सुरक्षित प्रमाणीकरण लागू करें:

// Create user data (ideally on your server)
val userData = SecureSSOUserData(
    "user-id",
    "user@example.com",
    "User Name",
    "https://path-to-avatar.jpg"
)

// Generate SSO token (should be done server-side!)
val sso = FastCommentsSSO.createSecure("YOUR_API_KEY", userData)
val token = sso.prepareToSend()

// Add to config
config.sso = token

टिप्पणियों के साथ सोशल मीडिया शैली का फ़ीड प्रदर्शित करें:

// SDK कॉन्फ़िगर करें
CommentWidgetConfig config = new CommentWidgetConfig();
config.tenantId = "your-tenant-id";
config.urlId = "page-url-id";

// Feed SDK प्रारंभ करें
FastCommentsFeedSDK feedSDK = new FastCommentsFeedSDK(config);

// फ़ीड व्यू सेट अप करें
FastCommentsFeedView feedView = findViewById(R.id.feedView);
feedView.setSDK(feedSDK);

// इंटरैक्शन लिसनर सेट करें
feedView.setFeedViewInteractionListener(new FastCommentsFeedView.OnFeedViewInteractionListener() {
    @Override
    public void onFeedLoaded(List<FeedPost> posts) {
        // फ़ीड सफलतापूर्वक लोड हुआ
    }

    @Override
    public void onFeedError(String errorMessage) {
        // त्रुटियों को संभालें
    }

    @Override
    public void onPostSelected(FeedPost post) {
        // उपयोगकर्ता ने एक पोस्ट चुनी
    }

    @Override
    public void onCommentsRequested(FeedPost post) {
        // पोस्ट के लिए टिप्पणियाँ दिखाएँ
        CommentsDialog dialog = new CommentsDialog(context, post, feedSDK);
        dialog.show();
    }
});

// फ़ीड लोड करें
feedView.load();

अपने ऐप में एक रीयल-टाइम चैट इंटरफ़ेस जोड़ें:

// अपने लेआउट XML में LiveChatView जोड़ें
// <com.fastcomments.sdk.LiveChatView
//     android:id="@+id/liveChatView"
//     android:layout_width="match_parent"
//     android:layout_height="match_parent" />

// SDK के लिए एक कॉन्फ़िगरेशन बनाएं
val config = CommentWidgetConfig().apply {
    tenantId = "your-tenant-id"
    urlId = "chat-room-identifier" 
    pageTitle = "Chat Room Name"
}
LiveChatView.setupLiveChatConfig(config)

// वैकल्पिक: यूज़र ऑथेंटिकेशन जोड़ें
val userData = SimpleSSOUserData(
    "User Name",
    "user@example.com",
    "https://path-to-avatar.jpg"
)
val sso = FastCommentsSSO(userData)
config.sso = sso.prepareToSend()

// SDK को इनिशियलाइज़ करें
val sdk = FastCommentsSDK().configure(config)

// लाइव चैट व्यू सेट अप करें
val liveChatView = findViewById<LiveChatView>(R.id.liveChatView)
liveChatView.setSDK(sdk)
liveChatView.load()

// लाइफ़साइकिल हैंडलिंग करना न भूलें
override fun onResume() {
    super.onResume()
    sdk.refreshLiveEvents()
}

override fun onDestroy() {
    super.onDestroy()
    sdk.cleanup()
}

इन डेमो इम्प्लीमेंटेशन को देखें:

• बेसिक कमेंट्स उदाहरण
• सिक्योर SSO इम्प्लीमेंटेशन
• फ़ीड इंटीग्रेशन उदाहरण
• लाइव चैट उदाहरण
• कमेंट्स डायलॉग उदाहरण

SDK CommentWidgetConfig क्लास के माध्यम से कई कॉन्फ़िगरेशन विकल्प प्रदान करता है:

FastComments SDK में सभी बटन और UI तत्व थीमयोग्य हैं। अपने ऐप की ब्रांडिंग पर पूर्ण नियंत्रण के लिए FastCommentsTheme.Builder का उपयोग करें।

प्रोग्रामेटिक थीमिंग (अनुशंसित)

val theme = FastCommentsTheme.Builder()
    // एक्शन बटन: Send, vote, menu, like/share बटन
    .setActionButtonColor(Color.parseColor("#FF1976D2"))
    
    // रिप्लाई बटन: कमेंट रिप्लाई बटन  
    .setReplyButtonColor(Color.parseColor("#FF4CAF50"))
    
    // टॉगल बटन: Show/hide replies बटन
    .setToggleRepliesButtonColor(Color.parseColor("#FFFF5722"))
    
    // Load more बटन: पेजिनेशन बटन
    .setLoadMoreButtonTextColor(Color.parseColor("#FF9C27B0"))
    
    .setPrimaryColor(Color.parseColor("#FF6200EE"))
    .setLinkColor(Color.parseColor("#FF1976D2"))
    .setDialogHeaderBackgroundColor(Color.parseColor("#FF333333"))
    .build()

// थीम लागू करें
sdk.setTheme(theme)

त्वरित रंग ओवरराइड

सरल ब्रांडिंग के लिए अपने colors.xml में रंग संसाधनों को ओवरराइड करें:

<!-- अपने ऐप के res/values/colors.xml में -->
<resources>
    <!-- सभी प्राथमिक UI तत्व बदलें -->
    <color name="primary">#FF1976D2</color>
    
    <!-- या विशिष्ट बटन प्रकार अनुकूलित करें -->
    <color name="fastcomments_action_button_color">#FF1976D2</color>
    <color name="fastcomments_reply_button_color">#FF4CAF50</color>
    <color name="fastcomments_toggle_replies_button_color">#FFFF5722</color>
    <color name="fastcomments_load_more_button_text_color">#FF9C27B0</color>
</resources>

थीम वाले बटन कवरेज

SDK में हर बटन थीमिंग का समर्थन करता है:

• Send बटन, vote बटन, menu बटन, reply बटन
• Show/hide replies बटन, load more बटन
• फ़ीड एक्शन बटन (like, comment, share)
• डायलॉग बटन (submit, cancel, save)
• फ़ीड पोस्ट में डायनामिक टास्क बटन

विस्तृत थीमिंग दस्तावेज़ीकरण के लिए, THEMING.md देखें।

मेमोरी लीक को रोकना

Activities या Fragments में FastComments views का उपयोग करते समय मेमोरी लीक को रोकने के लिए, जब view की अब आवश्यकता न हो तो हमेशा cleanup() कॉल करें:

Activities में:

@Override
protected void onDestroy() {
    super.onDestroy();
    // मेमोरी लीक को रोकने के लिए FastComments views को क्लीन अप करें
    if (feedView != null) {
        feedView.cleanup();
    }
    if (commentsView != null) {
        commentsView.cleanup();
    }
}

Fragments में:

@Override
public void onDestroyView() {
    super.onDestroyView();
    // fragment view नष्ट होने पर FastComments views को क्लीन अप करें
    if (feedView != null) {
        feedView.cleanup();
        feedView = null;
    }
}

@Override
public void onDestroy() {
    super.onDestroy();
    // fragment नष्ट होने पर अतिरिक्त क्लीनअप
    if (feedSDK != null) {
        feedSDK.cleanup();
        feedSDK = null;
    }
}

Fragments बदलते समय:

// FastComments views वाले fragment को बदलने या हटाने से पहले
Fragment currentFragment = getSupportFragmentManager().findFragmentById(R.id.container);
if (currentFragment instanceof YourFragmentWithFeedView) {
    ((YourFragmentWithFeedView) currentFragment).cleanupFeedView();
}

// फिर fragment transaction के साथ आगे बढ़ें
getSupportFragmentManager().beginTransaction()
    .replace(R.id.container, newFragment)
    .commit();

महत्वपूर्ण: मेमोरी लीक को रोकने के लिए हमेशा cleanup() मेथड्स कॉल करें, विशेष रूप से जब:

• Activities नष्ट हो जाएं
• Fragment views नष्ट हो जाएं
• Fragments के बीच स्विच किया जा रहा हो
• FastComments components वाली screens से दूर नेविगेट किया जा रहा हो