Skip to content

Let's use AI to Earn!

tiktok

bulaienaofutuojiesenzhangd14f5d1017f7
diff --git a/src/components/PublishDialog/compoents/PlatParamsSetting/index.tsx b/src/components/PublishDialog/compoents/PlatParamsSetting/index.tsx
index e2a66ea1..cee1690a 100644
--- a/src/components/PublishDialog/compoents/PlatParamsSetting/index.tsx
+++ b/src/components/PublishDialog/compoents/PlatParamsSetting/index.tsx
@@ -9,6 +9,7 @@ import InstagramParams from "@/components/PublishDialog/compoents/PlatParamsSett
import YouTubeParams from "@/components/PublishDialog/compoents/PlatParamsSetting/plats/YouTubeParams";
import WxGzhParams from "@/components/PublishDialog/compoents/PlatParamsSetting/plats/WxGzhParams";
import PinterestParams from "@/components/PublishDialog/compoents/PlatParamsSetting/plats/PinterestParams";
+import TikTokParams from "@/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams";
import { useShallow } from "zustand/react/shallow";
import { PubItem } from "@/components/PublishDialog/publishDialog.type";
@@ -53,6 +54,8 @@ const PlatParamsSetting = memo(
return <YouTubeParams pubItem={pubItem} />;
case PlatType.Pinterest:
return <PinterestParams pubItem={pubItem} />;
+ case PlatType.Tiktok:
+ return <TikTokParams pubItem={pubItem} />;
default:
return <KwaiParams pubItem={pubItem} />;
}
diff --git a/src/components/PublishDialog/compoents/PlatParamsSetting/plats/README.md b/src/components/PublishDialog/compoents/PlatParamsSetting/plats/README.md
new file mode 100644
index 00000000..7255cd61
--- /dev/null
+++ b/src/components/PublishDialog/compoents/PlatParamsSetting/plats/README.md
@@ -0,0 +1,127 @@
+# TikTokParams 组件
+
+## 概述
+
+TikTokParams 组件是专门为 TikTok 平台设计的发布参数设置组件,完全符合 TikTok 的 Content Posting API 开发指南要求。
+
+## 功能特性
+
+### 1. 创作者信息显示
+- 自动调用 `/api/plat/tiktok/creator/info/{tiktok_account_id}` API
+- 显示创作者头像、昵称和用户名
+- 根据 API 返回的 `max_video_post_duration_sec` 验证视频时长
+
+### 2. 隐私级别设置
+- 支持从 API 返回的 `privacy_level_options` 中选择
+- 选项包括:
+ - `PUBLIC_TO_EVERYONE` - 公开
+ - `MUTUAL_FOLLOW_FRIENDS` - 朋友
+ - `SELF_ONLY` - 仅自己
+- 用户必须手动选择,无默认值
+
+### 3. 用户交互权限
+- **评论权限** (`comment_disabled`)
+- **合拍权限** (`duet_disabled`)
+- **拼接权限** (`stitch_disabled`)
+- 根据 API 返回的禁用状态自动禁用相应选项
+- 用户必须手动开启,无默认选中
+
+### 4. 商业内容披露
+- 商业内容披露开关
+- 两个选项:
+ - **您的品牌** (`brand_organic_toggle`) - 推广自己或自己的业务
+ - **品牌内容** (`brand_content_toggle`) - 推广其他品牌或第三方
+- 至少选择一个选项才能发布
+
+### 5. 合规声明
+根据选择的商业内容类型显示不同的合规声明:
+
+- **默认情况**:发布即表示您同意 TikTok 的音乐使用确认
+- **仅选择"您的品牌"**:发布即表示您同意 TikTok 的音乐使用确认
+- **仅选择"品牌内容"**:发布即表示您同意 TikTok 的品牌内容政策音乐使用确认
+- **同时选择两者**:发布即表示您同意 TikTok 的品牌内容政策音乐使用确认
+
+## API 接口
+
+### 获取创作者信息
+```
+GET /api/plat/tiktok/creator/info/{tiktok_account_id}
+```
+
+**响应格式:**
+```json
+{
+ "data": {
+ "max_video_post_duration_sec": 3600,
+ "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
+ "stitch_disabled": false,
+ "comment_disabled": false,
+ "creator_avatar_url": "https://...",
+ "creator_nickname": "straydog",
+ "creator_username": "__straydog__",
+ "duet_disabled": false
+ },
+ "code": 0,
+ "message": "请求成功"
+}
+```
+
+## 多语言支持
+
+组件支持中英文双语:
+
+### 中文 (zh-CN)
+- 创作者信息
+- 谁可以观看此视频
+- 允许用户
+- 披露视频内容
+- 合规声明
+
+### 英文 (en)
+- Creator Info
+- Who can view this video
+- Allow users to
+- Disclose video content
+- Compliance declarations
+
+## 使用方法
+
+```tsx
+import TikTokParams from '@/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams';
+
+<TikTokParams pubItem={pubItem} />
+```
+
+## 参数结构
+
+```typescript
+interface TikTokOption {
+ privacy_level: string;
+ comment_disabled: boolean;
+ duet_disabled: boolean;
+ stitch_disabled: boolean;
+ brand_organic_toggle: boolean;
+ brand_content_toggle: boolean;
+}
+```
+
+## 符合 TikTok 开发指南
+
+本组件完全符合 [TikTok Content Sharing Guidelines](https://developers.tiktok.com/doc/content-sharing-guidelines#required_ux_implementation_in_your_app) 的要求:
+
+1. ✅ 显示创作者昵称和头像
+2. ✅ 检查创作者发布限制
+3. ✅ 验证视频时长限制
+4. ✅ 隐私级别手动选择
+5. ✅ 交互权限手动设置
+6. ✅ 商业内容披露功能
+7. ✅ 合规声明显示
+8. ✅ 无默认值设置
+9. ✅ 用户完全控制发布内容
+
+## 注意事项
+
+1. 组件会自动初始化 TikTok 参数,如果不存在则创建默认值
+2. API 调用失败时会静默处理,不影响组件正常使用
+3. 所有用户交互都有相应的状态管理和参数更新
+4. 组件支持响应式设计,适配不同屏幕尺寸
diff --git a/src/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams.test.tsx b/src/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams.test.tsx
new file mode 100644
index 00000000..3b060417
--- /dev/null
+++ b/src/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams.test.tsx
@@ -0,0 +1,95 @@
+import React from 'react';
+import { render, screen } from '@testing-library/react';
+import TikTokParams from './TikTokParams';
+
+// Mock the dependencies
+jest.mock('@/app/i18n/client', () => ({
+ useTransClient: () => ({
+ t: (key: string) => key,
+ }),
+}));
+
+jest.mock('@/components/PublishDialog/compoents/PlatParamsSetting/hooks/usePlatParamsCoomon', () => ({
+ __esModule: true,
+ default: () => ({
+ pubParmasTextareaCommonParams: {},
+ setOnePubParams: jest.fn(),
+ }),
+}));
+
+jest.mock('@/utils/request', () => ({
+ apiRequest: {
+ get: jest.fn(),
+ },
+}));
+
+// Mock PubParmasTextarea component
+jest.mock('@/components/PublishDialog/compoents/PubParmasTextarea', () => {
+ return function MockPubParmasTextarea({ extend }: { extend: React.ReactNode }) {
+ return <div data-testid="pub-params-textarea">{extend}</div>;
+ };
+});
+
+// Mock CommonTitleInput component
+jest.mock('@/components/PublishDialog/compoents/PlatParamsSetting/common/CommonTitleInput', () => {
+ return function MockCommonTitleInput() {
+ return <div data-testid="common-title-input">Title Input</div>;
+ };
+});
+
+describe('TikTokParams', () => {
+ const mockPubItem = {
+ account: {
+ id: 'test-account-id',
+ account: 'test-tiktok-account',
+ type: 'tiktok',
+ },
+ params: {
+ option: {
+ tiktok: {
+ privacy_level: '',
+ comment_disabled: false,
+ duet_disabled: false,
+ stitch_disabled: false,
+ brand_organic_toggle: false,
+ brand_content_toggle: false,
+ },
+ },
+ },
+ };
+
+ it('renders TikTokParams component', () => {
+ render(<TikTokParams pubItem={mockPubItem} />);
+
+ expect(screen.getByTestId('pub-params-textarea')).toBeInTheDocument();
+ expect(screen.getByTestId('common-title-input')).toBeInTheDocument();
+ });
+
+ it('displays creator info section', () => {
+ render(<TikTokParams pubItem={mockPubItem} />);
+
+ // Check if creator info label is present
+ expect(screen.getByText('tiktok.creatorInfo')).toBeInTheDocument();
+ });
+
+ it('displays privacy level section', () => {
+ render(<TikTokParams pubItem={mockPubItem} />);
+
+ // Check if privacy level label is present
+ expect(screen.getByText('tiktok.privacy.title')).toBeInTheDocument();
+ });
+
+ it('displays interactions section', () => {
+ render(<TikTokParams pubItem={mockPubItem} />);
+
+ // Check if interactions label is present
+ expect(screen.getByText('tiktok.interactions.title')).toBeInTheDocument();
+ });
+
+ it('displays commercial content section', () => {
+ render(<TikTokParams pubItem={mockPubItem} />);
+
+ // Check if commercial content label is present
+ expect(screen.getByText('tiktok.commercial.title')).toBeInTheDocument();
+ });
+});
diff --git a/src/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams.tsx b/src/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams.tsx
new file mode 100644
index 00000000..d7f184d4
--- /dev/null
+++ b/src/components/PublishDialog/compoents/PlatParamsSetting/plats/TikTokParams.tsx
@@ -0,0 +1,251 @@
+import { ForwardedRef, forwardRef, memo, useEffect, useState } from "react";
+import {
+ IPlatsParamsProps,
+ IPlatsParamsRef,
+} from "@/components/PublishDialog/compoents/PlatParamsSetting/plats/plats.type";
+import PubParmasTextarea from "@/components/PublishDialog/compoents/PubParmasTextarea";
+import usePlatParamsCommon from "@/components/PublishDialog/compoents/PlatParamsSetting/hooks/usePlatParamsCoomon";
+import CommonTitleInput from "@/components/PublishDialog/compoents/PlatParamsSetting/common/CommonTitleInput";
+import styles from "../platParamsSetting.module.scss";
+import { Select, Checkbox, Switch, Alert } from "antd";
+import { useTransClient } from "@/app/i18n/client";
+import { apiRequest } from "@/utils/request";
+
+// TikTok Creator Info 接口类型
+interface TikTokCreatorInfo {
+ max_video_post_duration_sec: number;
+ privacy_level_options: string[];
+ stitch_disabled: boolean;
+ comment_disabled: boolean;
+ creator_avatar_url: string;
+ creator_nickname: string;
+ creator_username: string;
+ duet_disabled: boolean;
+}
+
+const TikTokParams = memo(
+ forwardRef(
+ ({ pubItem }: IPlatsParamsProps, ref: ForwardedRef<IPlatsParamsRef>) => {
+ const { t } = useTransClient("publish");
+ const { pubParmasTextareaCommonParams, setOnePubParams } =
+ usePlatParamsCommon(pubItem);
+
+ const [creatorInfo, setCreatorInfo] = useState<TikTokCreatorInfo | null>(null);
+ const [loading, setLoading] = useState(false);
+
+ // 获取 TikTok Creator Info
+ const fetchCreatorInfo = async () => {
+ try {
+ setLoading(true);
+ const response = await apiRequest.get(`/api/plat/tiktok/creator/info/${pubItem.account.account}`);
+ if (response.data.code === 0) {
+ setCreatorInfo(response.data.data);
+ }
+ } catch (error) {
+ console.error('Failed to fetch TikTok creator info:', error);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ // 初始化 TikTok 参数
+ useEffect(() => {
+ const option = pubItem.params.option;
+ if (!option.tiktok) {
+ option.tiktok = {
+ privacy_level: '',
+ comment_disabled: false,
+ duet_disabled: false,
+ stitch_disabled: false,
+ brand_organic_toggle: false,
+ brand_content_toggle: false,
+ };
+ setOnePubParams({ option }, pubItem.account.id);
+ }
+ fetchCreatorInfo();
+ }, [pubItem.account.id, pubItem.account.account]);
+
+ // 隐私级别选项映射
+ const getPrivacyLevelLabel = (value: string) => {
+ switch (value) {
+ case 'PUBLIC_TO_EVERYONE':
+ return t('tiktok.privacy.public');
+ case 'MUTUAL_FOLLOW_FRIENDS':
+ return t('tiktok.privacy.friends');
+ case 'SELF_ONLY':
+ return t('tiktok.privacy.private');
+ default:
+ return value;
+ }
+ };
+
+ // 获取合规声明文本
+ const getComplianceText = () => {
+ const { brand_organic_toggle, brand_content_toggle } = pubItem.params.option.tiktok || {};
+
+ if (brand_organic_toggle && brand_content_toggle) {
+ return t('tiktok.compliance.both');
+ } else if (brand_content_toggle) {
+ return t('tiktok.compliance.branded');
+ } else if (brand_organic_toggle) {
+ return t('tiktok.compliance.organic');
+ } else {
+ return t('tiktok.compliance.default');
+ }
+ };
+
+ return (
+ <>
+ <PubParmasTextarea
+ {...pubParmasTextareaCommonParams}
+ extend={
+ <>
+ <CommonTitleInput pubItem={pubItem} />
+
+ {/* Creator Info Display */}
+ {creatorInfo && (
+ <div className={styles.commonTitleInput} style={{ marginTop: "10px" }}>
+ <div className="platParamsSetting-label">{t('tiktok.creatorInfo')}</div>
+ <div style={{
+ display: 'flex',
+ alignItems: 'center',
+ gap: '8px',
+ padding: '8px',
+ background: '#f5f5f5',
+ borderRadius: '4px'
+ }}>
+ <img
+ src={creatorInfo.creator_avatar_url}
+ alt="Creator Avatar"
+ style={{ width: '32px', height: '32px', borderRadius: '50%' }}
+ />
+ <span style={{ fontWeight: 500 }}>{creatorInfo.creator_nickname}</span>
+ <span style={{ color: '#666' }}>(@{creatorInfo.creator_username})</span>
+ </div>
+ </div>
+ )}
+
+ {/* Privacy Level Selection */}
+ {creatorInfo && (
+ <div className={styles.commonTitleInput} style={{ marginTop: "10px" }}>
+ <div className="platParamsSetting-label">{t('tiktok.privacy.title')}</div>
+ <Select
+ style={{ width: "100%" }}
+ value={pubItem.params.option.tiktok?.privacy_level}
+ onChange={(value) => {
+ const option = pubItem.params.option;
+ option.tiktok!.privacy_level = value;
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ placeholder={t('tiktok.privacy.placeholder')}
+ options={creatorInfo.privacy_level_options.map(level => ({
+ value: level,
+ label: getPrivacyLevelLabel(level)
+ }))}
+ />
+ </div>
+ )}
+
+ {/* Allow users to interact */}
+ <div className={styles.commonTitleInput} style={{ marginTop: "10px" }}>
+ <div className="platParamsSetting-label">{t('tiktok.interactions.title')}</div>
+ <div style={{ display: 'flex', flexDirection: 'row', gap: '8px' }}>
+ <Checkbox
+ checked={!pubItem.params.option.tiktok?.comment_disabled}
+ disabled={creatorInfo?.comment_disabled}
+ onChange={(e) => {
+ const option = pubItem.params.option;
+ option.tiktok!.comment_disabled = !e.target.checked;
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ >
+ {t('tiktok.interactions.comment')}
+ </Checkbox>
+ <Checkbox
+ checked={!pubItem.params.option.tiktok?.duet_disabled}
+ disabled={creatorInfo?.duet_disabled}
+ onChange={(e) => {
+ const option = pubItem.params.option;
+ option.tiktok!.duet_disabled = !e.target.checked;
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ >
+ {t('tiktok.interactions.duet')}
+ </Checkbox>
+ <Checkbox
+ checked={!pubItem.params.option.tiktok?.stitch_disabled}
+ disabled={creatorInfo?.stitch_disabled}
+ onChange={(e) => {
+ const option = pubItem.params.option;
+ option.tiktok!.stitch_disabled = !e.target.checked;
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ >
+ {t('tiktok.interactions.stitch')}
+ </Checkbox>
+ </div>
+ </div>
+
+ {/* Commercial Content Disclosure */}
+ <div className={styles.commonTitleInput} style={{ marginTop: "10px" }}>
+ <div className="platParamsSetting-label">{t('tiktok.commercial.title')}</div>
+ <div style={{ marginBottom: '8px' }}>
+ <Switch
+ checked={pubItem.params.option.tiktok?.brand_organic_toggle || pubItem.params.option.tiktok?.brand_content_toggle}
+ onChange={(checked) => {
+ const option = pubItem.params.option;
+ if (!checked) {
+ option.tiktok!.brand_organic_toggle = false;
+ option.tiktok!.brand_content_toggle = false;
+ }
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ />
+ <span style={{ marginLeft: '8px', fontSize: '11px' }}>{t('tiktok.commercial.toggle')}</span>
+ </div>
+
+ {(pubItem.params.option.tiktok?.brand_organic_toggle || pubItem.params.option.tiktok?.brand_content_toggle) && (
+ <div style={{ display: 'flex', flexDirection: 'column', gap: '8px', marginTop: '8px' }}>
+ <Checkbox
+ checked={pubItem.params.option.tiktok?.brand_organic_toggle}
+ onChange={(e) => {
+ const option = pubItem.params.option;
+ option.tiktok!.brand_organic_toggle = e.target.checked;
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ >
+ {t('tiktok.commercial.yourBrand')}
+ </Checkbox>
+ <Checkbox
+ checked={pubItem.params.option.tiktok?.brand_content_toggle}
+ onChange={(e) => {
+ const option = pubItem.params.option;
+ option.tiktok!.brand_content_toggle = e.target.checked;
+ setOnePubParams({ option }, pubItem.account.id);
+ }}
+ >
+ {t('tiktok.commercial.brandedContent')}
+ </Checkbox>
+ </div>
+ )}
+ </div>
+
+ {/* Compliance Declaration */}
+ <div className={styles.commonTitleInput} style={{ marginTop: "10px" }}>
+ <Alert
+ message={getComplianceText()}
+ type="info"
+ showIcon
+ style={{ fontSize: '12px' }}
+ />
+ </div>
+ </>
+ }
+ />
+ </>
+ );
+ },
+ ),
+);
+
+export default TikTokParams;