开发者接入指引

1 三星智慧主页服务介绍

- 具备动态运营能力,如推荐新上线的卡片。

- 本机上已经安装了支持三星智慧主页小组件的应用时展示其小组件。

- 原则上应用程序所有者自行决定卡片上架和下架。但若卡片有品质问题,或者违反了双方合作协议约定等,负一屏服务运营者可以临时下架卡片(仅限负一屏位置的卡片),待问题解决后再上架此小组件。



2 接入流程说明

* 提供的信息和材料超出授权期或有效期或者发生其他变更时,您应当及时在智慧主页开发者平台进行更新。

上述环节,均需要平台方审核。

2.1 账户注册
登录和注册
  • 登录时需要三星帐户(建议您使用和三星应用商店相同的三星帐户管理智慧主页开发者平台)
  • 如无,将引导您注册三星帐户。注册时建议您选择“使用电子邮件地址”创建。
  • 平台相关事件将会通过通知方式发送到注册绑定的邮箱,请您对此邮箱邮件动态保持关注。

    未绑定邮箱时

    如果您已使用手机号码注册了三星帐户,但三星帐户没有绑定邮箱,登录并创建三星智慧主页开发者平台帐户时将会邀请您在三星帐户上绑定邮箱。

    点击前往绑定 >> 跳转至三星帐户服务登录页

    点击“添加”>>

    输入邮箱地址,点击“发送验证码”,按三星帐户网站指引完成添加邮箱的其他校验步骤。 成功添加邮箱地址后,再次回到“三星智慧主页开发者平台”,退出后重新登录三星帐户,即可开始创建账号操作。

    账户信息修改

    在账户注册成功后,您可以修改账户的信息,但账户信息修改提交后,您的账户将会冻结,直至信息修改被审核通过。

    2.2 应用注册信息提交

    您可以 在“首页”>>“我的应用”模块 点击 创建应用。

    应用注册并审核通过后,若该应用下有卡片在审核或已上线,则无法修改APP相关信息,也无法直接下线APP。请注意复核您的APP信息。



    3 卡片设计规范
  • 支持2*2,4*2,4*4大小卡片。
  • 小组件角弧度(系统会强制切成规定的圆角)、外围间距、浅色&深色模式、字体(建议设置成系统字体)及大小等,请按GUI要求支持。


  • 4 卡片技术规范
    4.1 基本要求
  • 小组件刷新:App主动刷新,三星智慧主页广播刷新,小组件卡片上的用户刷新按钮。
  • Widget内禁止的操作:小组件内的上下滑动(list view、scroll view等)、左右滑动(堆叠、tabs);输入文字。
  • Widget内允许的操作:点击
  • 小组件的父容器“宽”和“高”都设置为match_parent,内容居中。

    android:layout_width="match_parent"

    android:layout_height="match_parent"

    android:gravity="center"

  • 若需要在进入负一屏时刷新小组件内容,请支持负一屏广播解析 (后面附上示例代码)处理。
  • 小组件可以支持设置页面,长摁小组件时可显示【设置】菜单,点击进入设置页面。(从APP中读取)
  • 4.2 三星智慧主页广播刷新的实现方式
  • CP小组件广播需要在清单中添加负一屏更新广播。
  • <receiver android:name=".TestAppWidget" android:exported="true">
        <intent-filter>
            //android系统原生广播
            <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            //三星负一屏更新广播
            <action android:name="com.samsung.android.app.spage.action.CARD_UPDATE" />
        </intent-filter>
    </receiver>
  • 在接收到负一屏广播后,获取需要更新的appWidgetId 进行更新即可。
  • @Override
        public void onReceive(Context context, Intent intent) {
            super.onReceive(context, intent);
            if ("com.samsung.android.app.spage.action.CARD_UPDATE".equals(intent.getAction())){
                int appWidgetId = intent.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID,-1);
                Log.d("TestAppWidget"," onReceive action : " + intent.getAction() + " appWidgetId : " + appWidgetId);
                if (appWidgetId > 0){
                    //更新小组件
                    updateAppWidget(context,AppWidgetManager.getInstance(context),appWidgetId);
                }
            }
        }
  • 曝光刷新功能需要在清单中添加对应的meta-data参数才能支持刷新。
  • <receiver android:name=".TestAppWidget" android:exported="true">
        <intent-filter>
            <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            <action android:name="com.samsung.android.app.spage.action.CARD_UPDATE" />
        </intent-filter>
        <meta-data android:name="android.appwidget.provider" android:resource="@xml/test_app_widget_info" />
        <meta-data
            //设置该meta-data,能使小组件在负一屏曝光该组件时收到刷新广播
            android:name="oneUiWidgetRefreshInterval“
            //曝光的时间间隔,毫秒级
            android:value=“15000" />
        <meta-data
            //设置该meta-data,设置该小组件的版本号
            android:name="oneUiWidgetVersion" android:value="1" />
    </receiver>
    4.3 进入自测环境
  • 在完成“账户注册”,“应用注册”以后,请再按如下路径操作:”卡片 > 卡片管理 > 新增卡片 > 输入卡片信息(含“选择归属应用”),点击 “保存”

    注意:没有完成自测的卡片请务必不要提交,节省资源和提升效率 。

  • 手机“我的文件” > “内部存储”根目录下创建:“daylite.test”文件夹,文件夹包含文件“APPID1.test”, “APPID2.test”, ...可配置同时测试多个APP。
  • 注意:文件的后缀拓展名不再是txt, 应该是test.

      错误示例:1691234567.test.txt

    您也可以通过如下adb 命令实现上述操作:

    1.adb shell

    2.cd sdcard/

    3.mkdir daylite.test

    4.cd daylite.test/

    5.touch 1691234567.test

    1. 配置完成后,请重置“三星智慧主页”APP,重置路径参考:APP首页 > 更多 > 设置 > 注销三星智慧主页。

    2. 再次进入“三星智慧主页”APP,初始化后,前往卡片中心(APP首页右上角“+”),即可找到待测应用的待测卡片。


  • 合作方的APPID可在此路径查看:三星智慧主页开发者平台首页 > 我的应用 > 点击目标应用 > 在目标应用详情页中展示。
  • 自测环境需要在“三星智慧主页”客户端版本处在V4.0.03.10或以上才支持。


  • 5 卡片内容规范

    详见“三星智慧主页“卡片内容规范



    6 卡片信息提交和卡片管理

    创建应用并在应用审核通过后,即可提交卡片上线申请,并在卡片管理页面完成状态查询,信息修改,增加卡片版本,卡片下线等操作。

    菜单路径:首页> 卡片 > 进入“卡片管理”页面

    6.1 卡片上线

    在“卡片管理”页面,点击“新增卡片”进行创建。

    6.2 卡片信息修改

    在卡片完成上线审核后,若需要更改卡片信息,你可以进入该卡片详情页,编辑可修改信息后提交。审核后将会直接更新相关信息。

    6.3 卡片新增版本

    您可以为一张卡片添加多个版本。此时需要注意设置不同版本的该卡片所支持的APP版本区间。

    * 新增卡片版本要求保持上版本卡片的功能定位,以延续用户对此前使用场景需求的期望。

    6.4 卡片下线

    平台根据合作情况,保留下线卡片的权利,此时卡片将进入被平台下架状态。 合作方根据自身运用需求,主动申请下线卡片(某一或所有)卡片版本。



    7 联系我们

    针对某一卡片的相关业务,您可以直接在“卡片详情页” 底部直接向平台管理员发表评论。其他对接问题,您可以在 “帮助中心” > “联系我们”向我们发起提问。

    同时平台会发布相关公告和通知,请您留意。